@relyio/sdk 0.15.0 → 0.17.0

package/dist/index.cjs

@@ -2,9 +2,10 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var chunkX4KSS7PP_cjs = require('./chunk-X4KSS7PP.cjs');
-var chunk3BHDGUNS_cjs = require('./chunk-3BHDGUNS.cjs');
+var chunkGHYB6IZK_cjs = require('./chunk-GHYB6IZK.cjs');
+var chunk6E22GYPB_cjs = require('./chunk-6E22GYPB.cjs');
 require('./chunk-LSRPMNPT.cjs');
+var chunk6PTRZP5U_cjs = require('./chunk-6PTRZP5U.cjs');
 require('./chunk-PPA2WWOH.cjs');
 var chunkTZL374LS_cjs = require('./chunk-TZL374LS.cjs');
 var chunkRSHMA4KT_cjs = require('./chunk-RSHMA4KT.cjs');
@@ -21,9 +22,9 @@ function stopOnUnknownAnswer(_answer) {
 }
 chunkMWMSFIWN_cjs.__name(stopOnUnknownAnswer, "stopOnUnknownAnswer");
 function classifyFollowFailure(error) {
-  if (error instanceof chunk3BHDGUNS_cjs.LiveEdgeError) return liveEdgeVerdict(error);
-  if (!(error instanceof chunk3BHDGUNS_cjs.SDKError) || !error.retryable) return { retry: false };
-  const afterMs = chunk3BHDGUNS_cjs.serviceInstructedDelayMs(error, Date.now());
+  if (error instanceof chunk6E22GYPB_cjs.LiveEdgeError) return liveEdgeVerdict(error);
+  if (!(error instanceof chunk6E22GYPB_cjs.SDKError) || !error.retryable) return { retry: false };
+  const afterMs = chunk6E22GYPB_cjs.serviceInstructedDelayMs(error, Date.now());
   return afterMs === void 0 ? { retry: true } : { retry: true, afterMs };
 }
 chunkMWMSFIWN_cjs.__name(classifyFollowFailure, "classifyFollowFailure");
@@ -37,7 +38,7 @@ function liveEdgeVerdict(error) {
       return { retry: true, ...hint };
     }
     case "back-off": {
-      return { retry: true, ...hint, backOffMs: chunk3BHDGUNS_cjs.VISITOR_ADMISSION_RETRY_AFTER_SECONDS * 1e3 };
+      return { retry: true, ...hint, backOffMs: chunk6PTRZP5U_cjs.VISITOR_ADMISSION_RETRY_AFTER_SECONDS * 1e3 };
     }
     default: {
       return stopOnUnknownAnswer(error.retry);
@@ -50,10 +51,10 @@ async function followChanges(source, options) {
   const classify = options.classify ?? classifyFollowFailure;
   const random = options.random ?? Math.random;
   const report = /* @__PURE__ */ chunkMWMSFIWN_cjs.__name((state) => {
-    if (!chunk3BHDGUNS_cjs.isAborted(signal)) options.onState?.(state);
+    if (!chunk6E22GYPB_cjs.isAborted(signal)) options.onState?.(state);
   }, "report");
   const resync = /* @__PURE__ */ chunkMWMSFIWN_cjs.__name(async (cause) => {
-    if (chunk3BHDGUNS_cjs.isAborted(signal)) return;
+    if (chunk6E22GYPB_cjs.isAborted(signal)) return;
     await onResync(cause);
     report({ kind: "resynced", resync: cause });
   }, "resync");
@@ -62,12 +63,12 @@ async function followChanges(source, options) {
   let unanchored = false;
   let current;
   for (; ; ) {
-    if (chunk3BHDGUNS_cjs.isAborted(signal)) return { kind: "aborted", since };
+    if (chunk6E22GYPB_cjs.isAborted(signal)) return { kind: "aborted", since };
     try {
       if (unanchored) {
         unanchored = false;
         await resync({ cause: "no-cursor" });
-        if (chunk3BHDGUNS_cjs.isAborted(signal)) return { kind: "aborted", since };
+        if (chunk6E22GYPB_cjs.isAborted(signal)) return { kind: "aborted", since };
       }
       report({ kind: "following" });
       const open = {};
@@ -84,13 +85,13 @@ async function followChanges(source, options) {
         }, "reached")
       });
       for await (const change of changes) {
-        if (chunk3BHDGUNS_cjs.isAborted(signal)) return { kind: "aborted", since };
+        if (chunk6E22GYPB_cjs.isAborted(signal)) return { kind: "aborted", since };
         failures = 0;
         await onChange(change);
         since = change.cursor;
-        if (chunk3BHDGUNS_cjs.isAborted(signal)) return { kind: "aborted", since };
+        if (chunk6E22GYPB_cjs.isAborted(signal)) return { kind: "aborted", since };
       }
-      if (chunk3BHDGUNS_cjs.isAborted(signal)) return { kind: "aborted", since };
+      if (chunk6E22GYPB_cjs.isAborted(signal)) return { kind: "aborted", since };
       const error = new Error(
         "The change source completed without its signal aborting; a source ends only on abort and throws every other end."
       );
@@ -98,7 +99,7 @@ async function followChanges(source, options) {
       return { kind: "stopped", since, error };
     } catch (error) {
       current = void 0;
-      if (chunk3BHDGUNS_cjs.isAborted(signal)) return { kind: "aborted", since };
+      if (chunk6E22GYPB_cjs.isAborted(signal)) return { kind: "aborted", since };
       const verdict = classify(error);
       if (!verdict.retry) {
         report({ kind: "stopped", error });
@@ -107,7 +108,7 @@ async function followChanges(source, options) {
       failures += 1;
       const retryInMs = retryDelayMs(failures, verdict, random);
       report({ kind: "reconnecting", error, retryInMs });
-      await chunk3BHDGUNS_cjs.sleep(retryInMs, signal);
+      await chunk6E22GYPB_cjs.sleep(retryInMs, signal);
       if (since === void 0) unanchored = true;
     }
   }
@@ -279,227 +280,251 @@ var VERSION = "__VERSION__";
 
 Object.defineProperty(exports, "defineAssetType", {
   enumerable: true,
-  get: function () { return chunkX4KSS7PP_cjs.defineAssetType; }
+  get: function () { return chunkGHYB6IZK_cjs.defineAssetType; }
 });
 Object.defineProperty(exports, "defineContentType", {
   enumerable: true,
-  get: function () { return chunkX4KSS7PP_cjs.defineContentType; }
+  get: function () { return chunkGHYB6IZK_cjs.defineContentType; }
+});
+Object.defineProperty(exports, "defineLocale", {
+  enumerable: true,
+  get: function () { return chunkGHYB6IZK_cjs.defineLocale; }
 });
 Object.defineProperty(exports, "defineQuery", {
   enumerable: true,
-  get: function () { return chunkX4KSS7PP_cjs.defineQuery; }
+  get: function () { return chunkGHYB6IZK_cjs.defineQuery; }
 });
 Object.defineProperty(exports, "defineSchema", {
   enumerable: true,
-  get: function () { return chunkX4KSS7PP_cjs.defineSchema; }
+  get: function () { return chunkGHYB6IZK_cjs.defineSchema; }
 });
 Object.defineProperty(exports, "defineSettingsGroup", {
   enumerable: true,
-  get: function () { return chunkX4KSS7PP_cjs.defineSettingsGroup; }
+  get: function () { return chunkGHYB6IZK_cjs.defineSettingsGroup; }
 });
 Object.defineProperty(exports, "defineSingleton", {
   enumerable: true,
-  get: function () { return chunkX4KSS7PP_cjs.defineSingleton; }
+  get: function () { return chunkGHYB6IZK_cjs.defineSingleton; }
 });
 Object.defineProperty(exports, "fields", {
   enumerable: true,
-  get: function () { return chunkX4KSS7PP_cjs.fields; }
+  get: function () { return chunkGHYB6IZK_cjs.fields; }
 });
 Object.defineProperty(exports, "fieldset", {
   enumerable: true,
-  get: function () { return chunkX4KSS7PP_cjs.fieldset; }
+  get: function () { return chunkGHYB6IZK_cjs.fieldset; }
 });
 Object.defineProperty(exports, "AssetClient", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.AssetClient; }
+  get: function () { return chunk6E22GYPB_cjs.AssetClient; }
 });
 Object.defineProperty(exports, "AssetFileBuilder", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.AssetFileBuilder; }
+  get: function () { return chunk6E22GYPB_cjs.AssetFileBuilder; }
 });
 Object.defineProperty(exports, "AssetUploadBuilder", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.AssetUploadBuilder; }
+  get: function () { return chunk6E22GYPB_cjs.AssetUploadBuilder; }
 });
 Object.defineProperty(exports, "AuthorizationError", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.AuthorizationError; }
+  get: function () { return chunk6E22GYPB_cjs.AuthorizationError; }
 });
 Object.defineProperty(exports, "BaseValidationError", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.BaseValidationError; }
+  get: function () { return chunk6E22GYPB_cjs.BaseValidationError; }
 });
 Object.defineProperty(exports, "ChangesExpiredError", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.ChangesExpiredError; }
+  get: function () { return chunk6E22GYPB_cjs.ChangesExpiredError; }
 });
 Object.defineProperty(exports, "ConnectionError", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.ConnectionError; }
+  get: function () { return chunk6E22GYPB_cjs.ConnectionError; }
 });
 Object.defineProperty(exports, "ContentClient", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.ContentClient; }
+  get: function () { return chunk6E22GYPB_cjs.ContentClient; }
+});
+Object.defineProperty(exports, "DefaultRetryPolicy", {
+  enumerable: true,
+  get: function () { return chunk6E22GYPB_cjs.DefaultRetryPolicy; }
 });
 Object.defineProperty(exports, "ErrorMapper", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.ErrorMapper; }
+  get: function () { return chunk6E22GYPB_cjs.ErrorMapper; }
 });
 Object.defineProperty(exports, "FileUploadError", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.FileUploadError; }
+  get: function () { return chunk6E22GYPB_cjs.FileUploadError; }
 });
 Object.defineProperty(exports, "FileValidationError", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.FileValidationError; }
+  get: function () { return chunk6E22GYPB_cjs.FileValidationError; }
 });
 Object.defineProperty(exports, "HttpClient", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.HttpClient; }
+  get: function () { return chunk6E22GYPB_cjs.HttpClient; }
 });
 Object.defineProperty(exports, "InvalidApiKeyError", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.InvalidApiKeyError; }
+  get: function () { return chunk6E22GYPB_cjs.InvalidApiKeyError; }
 });
 Object.defineProperty(exports, "InvalidPayloadError", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.InvalidPayloadError; }
+  get: function () { return chunk6E22GYPB_cjs.InvalidPayloadError; }
 });
 Object.defineProperty(exports, "LIVE_KEEPALIVE_INTERVAL_MS", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.LIVE_KEEPALIVE_INTERVAL_MS; }
+  get: function () { return chunk6E22GYPB_cjs.LIVE_KEEPALIVE_INTERVAL_MS; }
 });
 Object.defineProperty(exports, "LIVE_SOCKET_OPEN_TIMEOUT_MS", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.LIVE_SOCKET_OPEN_TIMEOUT_MS; }
+  get: function () { return chunk6E22GYPB_cjs.LIVE_SOCKET_OPEN_TIMEOUT_MS; }
 });
 Object.defineProperty(exports, "LiveEdgeError", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.LiveEdgeError; }
+  get: function () { return chunk6E22GYPB_cjs.LiveEdgeError; }
 });
 Object.defineProperty(exports, "MethodNotAllowedError", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.MethodNotAllowedError; }
+  get: function () { return chunk6E22GYPB_cjs.MethodNotAllowedError; }
 });
 Object.defineProperty(exports, "MissingApiKeyError", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.MissingApiKeyError; }
+  get: function () { return chunk6E22GYPB_cjs.MissingApiKeyError; }
 });
 Object.defineProperty(exports, "NetworkError", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.NetworkError; }
+  get: function () { return chunk6E22GYPB_cjs.NetworkError; }
+});
+Object.defineProperty(exports, "PREVIEW_KEY_PREFIX", {
+  enumerable: true,
+  get: function () { return chunk6E22GYPB_cjs.PREVIEW_KEY_PREFIX; }
 });
 Object.defineProperty(exports, "PUBLISHABLE_KEY_PREFIX", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.PUBLISHABLE_KEY_PREFIX; }
+  get: function () { return chunk6E22GYPB_cjs.PUBLISHABLE_KEY_PREFIX; }
 });
 Object.defineProperty(exports, "PayloadTooLargeError", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.PayloadTooLargeError; }
+  get: function () { return chunk6E22GYPB_cjs.PayloadTooLargeError; }
 });
 Object.defineProperty(exports, "PlanFeatureUnavailableError", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.PlanFeatureUnavailableError; }
+  get: function () { return chunk6E22GYPB_cjs.PlanFeatureUnavailableError; }
 });
 Object.defineProperty(exports, "RateLimitError", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.RateLimitError; }
+  get: function () { return chunk6E22GYPB_cjs.RateLimitError; }
 });
 Object.defineProperty(exports, "ReadOnlyKeyError", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.ReadOnlyKeyError; }
+  get: function () { return chunk6E22GYPB_cjs.ReadOnlyKeyError; }
 });
 Object.defineProperty(exports, "ResourceConflictError", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.ResourceConflictError; }
+  get: function () { return chunk6E22GYPB_cjs.ResourceConflictError; }
 });
 Object.defineProperty(exports, "ResourceExpiredError", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.ResourceExpiredError; }
+  get: function () { return chunk6E22GYPB_cjs.ResourceExpiredError; }
 });
 Object.defineProperty(exports, "ResourceNotFoundError", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.ResourceNotFoundError; }
+  get: function () { return chunk6E22GYPB_cjs.ResourceNotFoundError; }
 });
 Object.defineProperty(exports, "SDKError", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.SDKError; }
+  get: function () { return chunk6E22GYPB_cjs.SDKError; }
 });
 Object.defineProperty(exports, "ServerError", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.ServerError; }
+  get: function () { return chunk6E22GYPB_cjs.ServerError; }
 });
 Object.defineProperty(exports, "ServiceIndeterminateError", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.ServiceIndeterminateError; }
+  get: function () { return chunk6E22GYPB_cjs.ServiceIndeterminateError; }
 });
 Object.defineProperty(exports, "SettingsClient", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.SettingsClient; }
+  get: function () { return chunk6E22GYPB_cjs.SettingsClient; }
 });
 Object.defineProperty(exports, "SingletonClient", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.SingletonClient; }
+  get: function () { return chunk6E22GYPB_cjs.SingletonClient; }
 });
 Object.defineProperty(exports, "TimeoutError", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.TimeoutError; }
+  get: function () { return chunk6E22GYPB_cjs.TimeoutError; }
 });
 Object.defineProperty(exports, "TransactionRolledBackError", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.TransactionRolledBackError; }
+  get: function () { return chunk6E22GYPB_cjs.TransactionRolledBackError; }
 });
 Object.defineProperty(exports, "TypedRelyIOClient", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.TypedRelyIOClient; }
+  get: function () { return chunk6E22GYPB_cjs.TypedRelyIOClient; }
 });
 Object.defineProperty(exports, "UnknownContractError", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.UnknownContractError; }
+  get: function () { return chunk6E22GYPB_cjs.UnknownContractError; }
 });
 Object.defineProperty(exports, "UsageQuotaExceededError", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.UsageQuotaExceededError; }
+  get: function () { return chunk6E22GYPB_cjs.UsageQuotaExceededError; }
 });
 Object.defineProperty(exports, "ValidationError", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.ValidationError; }
+  get: function () { return chunk6E22GYPB_cjs.ValidationError; }
 });
 Object.defineProperty(exports, "createClient", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.createClient; }
+  get: function () { return chunk6E22GYPB_cjs.createClient; }
 });
 Object.defineProperty(exports, "default", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.createClient; }
+  get: function () { return chunk6E22GYPB_cjs.createClient; }
 });
 Object.defineProperty(exports, "isAssetEntry", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.isAssetEntry; }
+  get: function () { return chunk6E22GYPB_cjs.isAssetEntry; }
 });
 Object.defineProperty(exports, "isMissingEntry", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.isMissingEntry; }
+  get: function () { return chunk6E22GYPB_cjs.isMissingEntry; }
+});
+Object.defineProperty(exports, "isPreviewKey", {
+  enumerable: true,
+  get: function () { return chunk6E22GYPB_cjs.isPreviewKey; }
 });
 Object.defineProperty(exports, "isPublishableKey", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.isPublishableKey; }
+  get: function () { return chunk6E22GYPB_cjs.isPublishableKey; }
+});
+Object.defineProperty(exports, "isReplaySafe", {
+  enumerable: true,
+  get: function () { return chunk6E22GYPB_cjs.isReplaySafe; }
 });
 Object.defineProperty(exports, "isResourceNotFound", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.isResourceNotFound; }
+  get: function () { return chunk6E22GYPB_cjs.isResourceNotFound; }
 });
 Object.defineProperty(exports, "matchRoute", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.matchRoute; }
+  get: function () { return chunk6E22GYPB_cjs.matchRoute; }
+});
+Object.defineProperty(exports, "retryPolicyFor", {
+  enumerable: true,
+  get: function () { return chunk6E22GYPB_cjs.retryPolicyFor; }
 });
 Object.defineProperty(exports, "validateFile", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.validateFile; }
+  get: function () { return chunk6E22GYPB_cjs.validateFile; }
 });
 Object.defineProperty(exports, "versionCheckOf", {
   enumerable: true,
-  get: function () { return chunk3BHDGUNS_cjs.versionCheckOf; }
+  get: function () { return chunk6E22GYPB_cjs.versionCheckOf; }
 });
 Object.defineProperty(exports, "camelToSnake", {
   enumerable: true,

package/dist/index.d.cts

@@ -1,12 +1,11 @@
-import { C as Change, a as ChangesExpiredError, b as ChangesExpiredReason } from './index-F0UuHpRj.cjs';
-export { i as ActiveSandbox, aI as AdhocQuery, aJ as AdhocRecord, aG as AggregateMetric, A as AnySchemaDefinition, m as ApiMethod, l as ApiPath, n as ApiSuccessBody, aR as AssetClient, a_ as AssetEntryResponse, aS as AssetFileBuilder, aY as AssetFileExtracted, b7 as AssetPlacement, aT as AssetUploadBuilder, aV as AssetVisibility, ai as AutocompleteOptions, ad as AutocompleteResponse, ac as AutocompleteSuggestion, ay as BatchBody, az as BatchCreate, aC as BatchDelete, aF as BatchDeleteTarget, at as BatchOperationResult, aB as BatchReplace, av as BatchResponse, aD as BatchSingletonWrite, au as BatchSummary, aE as BatchTarget, aA as BatchUpdate, aw as BatchWrite, ax as BatchWriteOptions, s as ChangesHeadOptions, t as ChangesOptions, U as ChildrenListOptions, Q as ChildrenOptions, e as ClientDefaults, f as ClientSchema, b2 as ConfirmInput, b3 as ConfirmResult, y as ContentClient, b6 as CreateAssetOptions, z as CreateEntryOptions, g as DeployedContentType, D as DeployedLocale, J as DocumentFields, V as DocumentReadOptions, K as DocumentVersion, N as DocumentVersionsOptions, O as DocumentWriteOptions, X as EntryList, E as EntryPlacement, B as EntryWriteOptions, F as FeedChange, Y as FieldKey, aX as FileBackend, bj as FileErrorCode, aW as FileStatus, aZ as FileStatusResult, bl as FileUploadError, bk as FileUploadErrorCode, bn as FileValidationConstraints, bm as FileValidationError, Z as FreshOption, _ as GetOptions, H as Health, j as HttpClient, u as LIVE_KEEPALIVE_INTERVAL_MS, w as LIVE_SOCKET_OPEN_TIMEOUT_MS, $ as ListAllOptions, a0 as ListOptions, x as LiveChangesOptions, L as LocaleCodeOf, a1 as LocaleOption, M as MatchRouteOptions, ba as MultipartCreateResult, bb as MultipartPart, bc as MultipartTarget, aK as NamedQueryOptions, aL as NamedQueryParams, a2 as Paging, a$ as PopulatedAssetReference, b0 as PresignInput, b1 as PresignResult, P as Project, aM as QueryAggregate, aN as QueryAnswer, aO as QueryCall, aH as QueryMetadata, aP as QueryName, aQ as QueryTypeName, a3 as ReadAs, q as ReadEntry, a4 as ReadLocale, R as Register, h as RegisteredSchema, b4 as ResolveUrlInput, b5 as ResolveUrlResult, bf as ResourceConflictError, bg as ResourceExpiredError, be as ResourceNotFoundError, r as RetryableWriteOptions, p as RouteMatch, S as SandboxState, ah as SearchEntry, aj as SearchFacet, ak as SearchFieldKey, al as SearchHighlight, aa as SearchHitMetadata, am as SearchOptions, an as SearchPage, ab as SearchResponse, a9 as SearchResultItem, ao as SearchScope, ap as SearchSelected, aq as SearchSortOption, ag as SearchTypeName, ar as SearchWhere, k as SendOptions, I as SettingsClient, as as SimilarOptions, af as SimilarResponse, ae as SimilarResult, G as SingletonClient, a5 as SortOption, d as TypedClientConfig, T as TypedRelyIOClient, b8 as UpdateAssetOptions, bd as UploadProgress, a6 as VersionOptions, b9 as WaitUntilReadyOptions, W as Wire, a7 as WrittenReadScope, a8 as WrittenSort, c as createClient, c as default, aU as isAssetEntry, bi as isMissingEntry, bh as isResourceNotFound, o as matchRoute, bo as validateFile, v as versionCheckOf } from './index-F0UuHpRj.cjs';
+import { C as Change, a as ChangesExpiredError, V as VisitorRetry, b as ChangesExpiredReason } from './index-DxRmKPrR.cjs';
+export { i as ActiveSandbox, aS as AdhocQuery, aT as AdhocRecord, aQ as AggregateMetric, A as AnySchemaDefinition, m as ApiMethod, l as ApiPath, n as ApiSuccessBody, a$ as AssetClient, b8 as AssetEntryResponse, b0 as AssetFileBuilder, b6 as AssetFileExtracted, b9 as AssetFileWhere, bi as AssetPlacement, b1 as AssetUploadBuilder, b3 as AssetVisibility, as as AutocompleteOptions, an as AutocompleteResponse, am as AutocompleteSuggestion, aI as BatchBody, aJ as BatchCreate, aM as BatchDelete, aP as BatchDeleteTarget, aD as BatchOperationResult, aL as BatchReplace, aF as BatchResponse, aN as BatchSingletonWrite, aE as BatchSummary, aO as BatchTarget, aK as BatchUpdate, aG as BatchWrite, aH as BatchWriteOptions, y as ChangesHeadOptions, z as ChangesOptions, aa as ChildEntry, a0 as ChildrenListOptions, $ as ChildrenOptions, ab as ChildrenRead, e as ClientDefaults, f as ClientSchema, bd as ConfirmInput, be as ConfirmResult, I as ContentClient, bh as CreateAssetOptions, J as CreateEntryOptions, s as DefaultRetryPolicy, g as DeployedContentType, D as DeployedLocale, U as DocumentFields, a1 as DocumentReadOptions, X as DocumentVersion, Y as DocumentVersionRow, Z as DocumentVersionsOptions, _ as DocumentWriteOptions, a2 as EntryList, K as EntryPlacement, N as EntryWriteOptions, F as FeedChange, a3 as FieldKey, b5 as FileBackend, bu as FileErrorCode, b4 as FileStatus, b7 as FileStatusResult, bw as FileUploadError, bv as FileUploadErrorCode, by as FileValidationConstraints, bx as FileValidationError, a4 as FreshOption, a5 as GetOptions, H as Health, j as HttpClient, B as LIVE_KEEPALIVE_INTERVAL_MS, E as LIVE_SOCKET_OPEN_TIMEOUT_MS, a6 as ListAllOptions, a7 as ListOptions, G as LiveChangesOptions, L as LocaleCodeOf, a8 as LocaleOption, M as MatchRouteOptions, bl as MultipartCreateResult, bm as MultipartPart, bn as MultipartTarget, aU as NamedQueryOptions, aV as NamedQueryParams, a9 as Paging, ba as PopulatedAssetReference, bb as PresignInput, bc as PresignResult, P as Project, aW as QueryAggregate, aX as QueryAnswer, aY as QueryCall, aR as QueryMetadata, aZ as QueryName, a_ as QueryTypeName, ac as ReadAs, q as ReadEntry, ae as ReadLocale, R as Register, h as RegisteredSchema, bf as ResolveUrlInput, bg as ResolveUrlResult, bq as ResourceConflictError, br as ResourceExpiredError, bp as ResourceNotFoundError, w as RetryPolicy, x as RetryableRequest, r as RetryableWriteOptions, p as RouteMatch, S as SandboxState, ar as SearchEntry, at as SearchFacet, au as SearchFieldKey, av as SearchHighlight, ak as SearchHitMetadata, aw as SearchOptions, ax as SearchPage, al as SearchResponse, aj as SearchResultItem, ay as SearchScope, az as SearchSelected, aA as SearchSortOption, aq as SearchTypeName, aB as SearchWhere, k as SendOptions, Q as SettingsClient, aC as SimilarOptions, ap as SimilarResponse, ao as SimilarResult, O as SingletonClient, af as SortOption, d as TypedClientConfig, T as TypedRelyIOClient, bj as UpdateAssetOptions, bo as UploadProgress, ag as VersionOptions, bk as WaitUntilReadyOptions, W as Wire, ad as WithChildren, ah as WrittenReadScope, ai as WrittenSort, c as createClient, c as default, b2 as isAssetEntry, bt as isMissingEntry, t as isReplaySafe, bs as isResourceNotFound, o as matchRoute, u as retryPolicyFor, bz as validateFile, v as versionCheckOf } from './index-DxRmKPrR.cjs';
 export { fields } from './schema/index.cjs';
-import { cl as SDKError, aM as EntryMetadata } from './define-content-type-B2gQZkTy.cjs';
-export { aH as AnyDeclaredFieldset, cS as ApiResponse, cq as AssetFileBlock, ak as AssetReading, b2 as AssetServedBlocks, a$ as AssetTypeDefinition, cr as AssetUrls, cs as BaseContent, B as BaseFieldConfig, cu as BaseSettingsGroup, ct as BaseSingleton, cY as BaseValidationError, ai as BlockOf, cO as CacheConfig, cU as CacheStrategy, am as CheckInclude, al as CheckedIncludes, an as ContentReading, aL as ContentTypeDefinition, cG as ContentTypeSchema, cA as CreateInput, cF as CustomQuery, cz as DateOnlyOperator, cQ as DebugConfig, aG as DeclaredFieldset, cW as Environment, h as FieldDefinition, aJ as FieldMember, cJ as FieldOptions, i as FieldRule, ac as FieldSchemaContext, j as FieldType, cH as FieldTypeName, k as FieldUIConfig, ad as FieldValue, ae as FieldValues, aF as Fieldset, b5 as FileKindConfig, bj as FileScanConfig, bi as FileUploadConfig, bb as ImageExifConfig, b3 as ImageKindConfig, ba as ImageSourceConfig, b9 as ImageUploadConfig, ao as IncludablePaths, b1 as InferAssetEntry, b0 as InferAssetType, aN as InferContentType, ca as InferJsonSchema, aT as InferSingleton, c_ as InvalidPayloadError, cb as JsonFieldValue, cc as JsonSchema, cd as JsonValue, ah as Keyed, a_ as KeyedAssetTypeConfig, aK as KeyedContentTypeConfig, K as KeyedEnumConfig, l as KeyedField, m as KeyedFieldOptions, aI as KeyedFieldsetConfig, aV as KeyedSettingsGroupConfig, aQ as KeyedSingletonConfig, co as LiveWebSocket, cp as LiveWebSocketConstructor, aO as LocalePublicationFields, r as LocalizationConfig, s as Localized, t as LocalizedDetails, cV as LogLevel, cN as PerformanceMetrics, aq as ReadWith, ap as Reading, cP as RealtimeConfig, cL as RealtimeEvent, cK as RealtimeEventType, cm as RelyIOConfig, cn as RelyIOConfigUpdate, cR as RequestConfig, cC as RestoredContent, cT as RetryConfig, cB as RevisedContent, aW as SettingsGroupDefinition, ar as SettingsReading, aj as ShapeValue, cE as SingletonContent, aR as SingletonContentTypeDefinition, aS as SingletonMetadata, as as SingletonReading, cM as SubscriptionOptions, ag as UnresolvedEntry, at as UntypedReading, cD as UpdateInput, cZ as ValidationError, cI as ValidationRule, cX as ValidationViolation, bc as VariantDefinition, bf as VideoCaptionsConfig, bg as VideoDownloadConfig, b4 as VideoKindConfig, be as VideoPosterConfig, bd as VideoUploadConfig, bh as VideoWatermarkConfig, cx as WhereClause, cw as WhereFieldCondition, cy as WhereOperator, cv as WhereScalar, W as WidgetOptions, aZ as defineAssetType, aD as defineContentType, aU as defineSettingsGroup, aP as defineSingleton, aE as fieldset } from './define-content-type-B2gQZkTy.cjs';
-import { VisitorRetry } from './live-visitor.js';
+import { cl as SDKError, aM as EntryMetadata } from './define-content-type-AuL9-oz6.cjs';
+export { aH as AnyDeclaredFieldset, cV as ApiResponse, cq as AssetFileBlock, ak as AssetReading, b2 as AssetServedBlocks, a$ as AssetTypeDefinition, cr as AssetUrls, cs as BaseContent, B as BaseFieldConfig, cu as BaseSettingsGroup, ct as BaseSingleton, c$ as BaseValidationError, ai as BlockOf, cS as CacheConfig, cX as CacheStrategy, am as CheckInclude, al as CheckedIncludes, an as ContentReading, aL as ContentTypeDefinition, cL as ContentTypeSchema, cG as ContentVersion, cH as ContentVersionRow, cA as CreateInput, cB as CreatedContent, cK as CustomQuery, cz as DateOnlyOperator, cT as DebugConfig, aG as DeclaredFieldset, cZ as Environment, h as FieldDefinition, aJ as FieldMember, cN as FieldOptions, i as FieldRule, ac as FieldSchemaContext, j as FieldType, k as FieldUIConfig, ad as FieldValue, ae as FieldValues, aF as Fieldset, b5 as FileKindConfig, bj as FileScanConfig, bi as FileUploadConfig, bb as ImageExifConfig, b3 as ImageKindConfig, ba as ImageSourceConfig, b9 as ImageUploadConfig, ao as IncludablePaths, b1 as InferAssetEntry, b0 as InferAssetType, aN as InferContentType, ca as InferJsonSchema, aT as InferSingleton, d1 as InvalidPayloadError, cb as JsonFieldValue, cc as JsonSchema, cd as JsonValue, ah as Keyed, a_ as KeyedAssetTypeConfig, aK as KeyedContentTypeConfig, K as KeyedEnumConfig, l as KeyedField, m as KeyedFieldOptions, aI as KeyedFieldsetConfig, aV as KeyedSettingsGroupConfig, aQ as KeyedSingletonConfig, co as LiveWebSocket, cp as LiveWebSocketConstructor, aO as LocalePublicationFields, r as LocalizationConfig, s as Localized, t as LocalizedDetails, cY as LogLevel, cR as PerformanceMetrics, aq as ReadWith, ap as Reading, cP as RealtimeEvent, cO as RealtimeEventType, cm as RelyIOConfig, cn as RelyIOConfigUpdate, cU as RequestConfig, cF as RestoredContent, cW as RetryConfig, cC as RevisedContent, aW as SettingsGroupDefinition, ar as SettingsReading, aj as ShapeValue, cJ as SingletonContent, aR as SingletonContentTypeDefinition, aS as SingletonMetadata, as as SingletonReading, cQ as SubscriptionOptions, ag as UnresolvedEntry, at as UntypedReading, cI as UpdateInput, d0 as ValidationError, cM as ValidationRule, c_ as ValidationViolation, bc as VariantDefinition, bf as VideoCaptionsConfig, bg as VideoDownloadConfig, b4 as VideoKindConfig, be as VideoPosterConfig, bd as VideoUploadConfig, bh as VideoWatermarkConfig, cx as WhereClause, cw as WhereFieldCondition, cy as WhereOperator, cv as WhereScalar, W as WidgetOptions, cE as WrittenSettingsGroup, cD as WrittenSingleton, aZ as defineAssetType, aD as defineContentType, au as defineLocale, aU as defineSettingsGroup, aP as defineSingleton, aE as fieldset } from './define-content-type-AuL9-oz6.cjs';
 export { camelToSnake, createDeferred, debounce, deepClone, generateId, isBrowser, isNode, isPlainObject, isValidEmail, isValidUrl, mergeDeep, omit, pick, retry, sleep, snakeToCamel, throttle, toSafeString } from './utils/index.cjs';
-export { n as RICH_TEXT_VOID_TAGS, R as RelyIOFieldAttributes, a as RelyIOFieldName, b as RelyIOFieldPath, c as RelyIOKeyed, q as RichTextAnchorsOption, t as RichTextAttributes, u as RichTextBlocksOf, v as RichTextDeclaredOf, w as RichTextDeclaredWriters, x as RichTextEntryLinkOf, y as RichTextEntryLinkOption, j as RichTextHtmlDeclaredWriters, k as RichTextHtmlFieldOption, l as RichTextHtmlOptions, z as RichTextInlineOf, m as RichTextMarkdownOptions, A as RichTextNodeContext, B as RichTextRenderable, C as RichTextRenderableOf, D as RichTextReplaceableNode, E as RichTextTag, F as RichTextTarget, e as entryHeadingAnchors, g as escapeHtml, o as isDeclaredRichTextNode, r as relyioField, p as renderRichText, d as richTextHeadingAnchors, f as richTextHeadingSlug, h as richTextToHtml, i as richTextToMarkdown, s as safeRichTextHref } from './index-DY64WjZM.cjs';
-export { A as AggregateBlock, L as AnyQueryParameters, M as DeclaredParameters, n as FetchBlock, w as FilterDefinition, I as IncludeDefinition, J as InferQueryParams, G as InferQueryResponse, Q as QueryConfig, l as QueryDefinition, K as QueryParameterValue, h as SchemaAssetTypeNames, S as SchemaConfig, b as SchemaContentTypeNames, a as SchemaDefinition, i as SchemaEntry, j as SchemaEntryOf, f as SchemaLocaleCodes, e as SchemaQueryNames, g as SchemaSettingsGroupNames, c as SchemaSingletonNames, o as SearchBlock, v as SelectMapping, s as SortCondition, W as WhereCondition, k as defineQuery, d as defineSchema } from './define-schema-Cm_5y3ei.cjs';
+export { n as RICH_TEXT_VOID_TAGS, R as RelyIOFieldAttributes, a as RelyIOFieldName, b as RelyIOFieldPath, c as RelyIOKeyed, q as RichTextAnchorsOption, t as RichTextAttributes, u as RichTextBlocksOf, v as RichTextDeclaredOf, w as RichTextDeclaredWriters, x as RichTextEntryLinkOf, y as RichTextEntryLinkOption, j as RichTextHtmlDeclaredWriters, k as RichTextHtmlFieldOption, l as RichTextHtmlOptions, z as RichTextInlineOf, m as RichTextMarkdownOptions, A as RichTextNodeContext, B as RichTextRenderable, C as RichTextRenderableOf, D as RichTextReplaceableNode, E as RichTextTag, F as RichTextTarget, e as entryHeadingAnchors, g as escapeHtml, o as isDeclaredRichTextNode, r as relyioField, p as renderRichText, d as richTextHeadingAnchors, f as richTextHeadingSlug, h as richTextToHtml, i as richTextToMarkdown, s as safeRichTextHref } from './index-Bp4AiNT3.cjs';
+export { A as AggregateBlock, L as AnyQueryParameters, M as DeclaredParameters, n as FetchBlock, w as FilterDefinition, I as IncludeDefinition, J as InferQueryParams, G as InferQueryResponse, Q as QueryConfig, l as QueryDefinition, K as QueryParameterValue, h as SchemaAssetTypeNames, S as SchemaConfig, b as SchemaContentTypeNames, a as SchemaDefinition, i as SchemaEntry, j as SchemaEntryOf, f as SchemaLocaleCodes, e as SchemaQueryNames, g as SchemaSettingsGroupNames, c as SchemaSingletonNames, o as SearchBlock, v as SelectMapping, s as SortCondition, W as WhereCondition, k as defineQuery, d as defineSchema } from './define-schema-DkXwpp0I.cjs';
 export { e as RichTextBlock, f as RichTextCellAlignment, g as RichTextCodeBlock, h as RichTextCodeGroup, i as RichTextCodeLines, j as RichTextDivider, d as RichTextEntryLinkMark, k as RichTextHeading, l as RichTextInline, m as RichTextLineBreak, n as RichTextLinkMark, o as RichTextList, p as RichTextListItem, q as RichTextListStyle, r as RichTextMark, s as RichTextMarkType, t as RichTextNode, u as RichTextParagraph, v as RichTextQuote, w as RichTextSpan, x as RichTextStructure, y as RichTextTable, z as RichTextTableCell, B as RichTextTableRow, b as RichTextValue } from './rich-text.d-BWc-5gX1.cjs';
 import './dev-handshake/index.cjs';
 
@@ -35,6 +34,18 @@ declare const PUBLISHABLE_KEY_PREFIX = "rly_pub_";
  * publishable key, so the answer is `false` rather than a `TypeError` in a caller that only asked.
  */
 declare const isPublishableKey: (apiKey: string | undefined) => boolean;
+/**
+ * A preview key's prefix: scope `prev`, the one project key that reads drafts and the only kind a
+ * client sends a pull request's preview dataset with (`github-integration-spec.md` decision 14).
+ * Restated from the service's `isPreviewApiKey` and held to it by `src/__tests__/key-kind.test.ts`,
+ * as the publishable prefix is.
+ */
+declare const PREVIEW_KEY_PREFIX = "rly_prev_";
+/**
+ * Whether `apiKey` is a preview key (`rly_prev_…`). It reads the prefix only, as
+ * {@link isPublishableKey} does; `undefined` — a client holding no key — is not one.
+ */
+declare const isPreviewKey: (apiKey: string | undefined) => boolean;
 
 /**
  * `followChanges()` — the one loop that follows a changes source until its
@@ -432,9 +443,13 @@ declare class PayloadTooLargeError extends SDKError {
     getUserMessage(): string;
 }
 /**
- * `TRANSACTION_ROLLED_BACK` — an atomic batch failed at one member and nothing
- * was written. `failedIndex` is which one, so a caller can fix that operation
- * rather than re-sending the whole batch blind.
+ * `TRANSACTION_ROLLED_BACK` — an atomic batch failed and nothing was written.
+ *
+ * `failedIndex` is the index, in the batch, of the operation this refusal was
+ * served for. The service sends each rolled-back item its **own** index, so it
+ * does not say which operation caused the rollback: read it as "this is
+ * operation N", never "operation N failed". Find the cause among the batch's
+ * results, not here.
  */
 declare class TransactionRolledBackError extends SDKError {
     readonly code = "TRANSACTION_ROLLED_BACK";
@@ -552,11 +567,6 @@ declare class LiveEdgeError extends SDKError {
         readonly retryAfterMs?: number;
         readonly context?: Record<string, unknown>;
     });
-    /**
-     * 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: Record<string, unknown>): this;
     getUserMessage(): string;
 }
 
@@ -972,4 +982,4 @@ declare function snapToLadder(value: number): number;
 
 declare const VERSION = "__VERSION__";
 
-export { AuthorizationError, Change, type ChangeSource, type ChangeSourceOptions, ChangesExpiredError, ChangesExpiredReason, ConnectionError, EntryMetadata, ErrorMapper, FOLLOW_BACK_OFF_MAX_MS, FOLLOW_RETRY_BASE_MS, FOLLOW_RETRY_MAX_MS, type FollowEnd, type FollowOptions, type FollowResync, type FollowState, type FollowVerdict, IMAGE_LADDER, InvalidApiKeyError, type KeyPathSegment, type LanguageSwitcherOption, type LanguageSwitcherOptions, type LiveEdgeEnd, LiveEdgeError, type LocaleMetadata, type LocaleStatus, type LocalizedEntry, MethodNotAllowedError, MissingApiKeyError, NetworkError, PUBLISHABLE_KEY_PREFIX, PayloadTooLargeError, PlanFeatureUnavailableError, RELYIO_CHANGE_EVENT, RELYIO_RESYNC_EVENT, RateLimitError, ReadOnlyKeyError, type RelyIOChangeDetail, type RelyIOResyncDetail, SDKError, ServerError, ServiceIndeterminateError, TimeoutError, TransactionRolledBackError, type TranslationCompleteness, UnknownContractError, UsageQuotaExceededError, VERSION, buildLanguageSwitcher, classifyFollowFailure, estimateTranslationCompleteness, followChanges, formatKeyPath, getAllLocalizedValues, getAvailableLocaleCodes, getDefaultLocale, getFallbackFields, getFieldFallbackLocale, getLocalizedField, getPublishedLocaleCodes, getRequestedLocale, hasLocale, isFieldFallback, isPublishableKey, isPublishedInLocale, localeHelpers, needsTranslation, parseKeyPath, snapToLadder };
+export { AuthorizationError, Change, type ChangeSource, type ChangeSourceOptions, ChangesExpiredError, ChangesExpiredReason, ConnectionError, EntryMetadata, ErrorMapper, FOLLOW_BACK_OFF_MAX_MS, FOLLOW_RETRY_BASE_MS, FOLLOW_RETRY_MAX_MS, type FollowEnd, type FollowOptions, type FollowResync, type FollowState, type FollowVerdict, IMAGE_LADDER, InvalidApiKeyError, type KeyPathSegment, type LanguageSwitcherOption, type LanguageSwitcherOptions, type LiveEdgeEnd, LiveEdgeError, type LocaleMetadata, type LocaleStatus, type LocalizedEntry, MethodNotAllowedError, MissingApiKeyError, NetworkError, PREVIEW_KEY_PREFIX, PUBLISHABLE_KEY_PREFIX, PayloadTooLargeError, PlanFeatureUnavailableError, RELYIO_CHANGE_EVENT, RELYIO_RESYNC_EVENT, RateLimitError, ReadOnlyKeyError, type RelyIOChangeDetail, type RelyIOResyncDetail, SDKError, ServerError, ServiceIndeterminateError, TimeoutError, TransactionRolledBackError, type TranslationCompleteness, UnknownContractError, UsageQuotaExceededError, VERSION, buildLanguageSwitcher, classifyFollowFailure, estimateTranslationCompleteness, followChanges, formatKeyPath, getAllLocalizedValues, getAvailableLocaleCodes, getDefaultLocale, getFallbackFields, getFieldFallbackLocale, getLocalizedField, getPublishedLocaleCodes, getRequestedLocale, hasLocale, isFieldFallback, isPreviewKey, isPublishableKey, isPublishedInLocale, localeHelpers, needsTranslation, parseKeyPath, snapToLadder };

package/dist/index.d.ts

@@ -1,12 +1,11 @@
-import { C as Change, a as ChangesExpiredError, b as ChangesExpiredReason } from './index-DQ7eTUPQ.js';
-export { i as ActiveSandbox, aI as AdhocQuery, aJ as AdhocRecord, aG as AggregateMetric, A as AnySchemaDefinition, m as ApiMethod, l as ApiPath, n as ApiSuccessBody, aR as AssetClient, a_ as AssetEntryResponse, aS as AssetFileBuilder, aY as AssetFileExtracted, b7 as AssetPlacement, aT as AssetUploadBuilder, aV as AssetVisibility, ai as AutocompleteOptions, ad as AutocompleteResponse, ac as AutocompleteSuggestion, ay as BatchBody, az as BatchCreate, aC as BatchDelete, aF as BatchDeleteTarget, at as BatchOperationResult, aB as BatchReplace, av as BatchResponse, aD as BatchSingletonWrite, au as BatchSummary, aE as BatchTarget, aA as BatchUpdate, aw as BatchWrite, ax as BatchWriteOptions, s as ChangesHeadOptions, t as ChangesOptions, U as ChildrenListOptions, Q as ChildrenOptions, e as ClientDefaults, f as ClientSchema, b2 as ConfirmInput, b3 as ConfirmResult, y as ContentClient, b6 as CreateAssetOptions, z as CreateEntryOptions, g as DeployedContentType, D as DeployedLocale, J as DocumentFields, V as DocumentReadOptions, K as DocumentVersion, N as DocumentVersionsOptions, O as DocumentWriteOptions, X as EntryList, E as EntryPlacement, B as EntryWriteOptions, F as FeedChange, Y as FieldKey, aX as FileBackend, bj as FileErrorCode, aW as FileStatus, aZ as FileStatusResult, bl as FileUploadError, bk as FileUploadErrorCode, bn as FileValidationConstraints, bm as FileValidationError, Z as FreshOption, _ as GetOptions, H as Health, j as HttpClient, u as LIVE_KEEPALIVE_INTERVAL_MS, w as LIVE_SOCKET_OPEN_TIMEOUT_MS, $ as ListAllOptions, a0 as ListOptions, x as LiveChangesOptions, L as LocaleCodeOf, a1 as LocaleOption, M as MatchRouteOptions, ba as MultipartCreateResult, bb as MultipartPart, bc as MultipartTarget, aK as NamedQueryOptions, aL as NamedQueryParams, a2 as Paging, a$ as PopulatedAssetReference, b0 as PresignInput, b1 as PresignResult, P as Project, aM as QueryAggregate, aN as QueryAnswer, aO as QueryCall, aH as QueryMetadata, aP as QueryName, aQ as QueryTypeName, a3 as ReadAs, q as ReadEntry, a4 as ReadLocale, R as Register, h as RegisteredSchema, b4 as ResolveUrlInput, b5 as ResolveUrlResult, bf as ResourceConflictError, bg as ResourceExpiredError, be as ResourceNotFoundError, r as RetryableWriteOptions, p as RouteMatch, S as SandboxState, ah as SearchEntry, aj as SearchFacet, ak as SearchFieldKey, al as SearchHighlight, aa as SearchHitMetadata, am as SearchOptions, an as SearchPage, ab as SearchResponse, a9 as SearchResultItem, ao as SearchScope, ap as SearchSelected, aq as SearchSortOption, ag as SearchTypeName, ar as SearchWhere, k as SendOptions, I as SettingsClient, as as SimilarOptions, af as SimilarResponse, ae as SimilarResult, G as SingletonClient, a5 as SortOption, d as TypedClientConfig, T as TypedRelyIOClient, b8 as UpdateAssetOptions, bd as UploadProgress, a6 as VersionOptions, b9 as WaitUntilReadyOptions, W as Wire, a7 as WrittenReadScope, a8 as WrittenSort, c as createClient, c as default, aU as isAssetEntry, bi as isMissingEntry, bh as isResourceNotFound, o as matchRoute, bo as validateFile, v as versionCheckOf } from './index-DQ7eTUPQ.js';
+import { C as Change, a as ChangesExpiredError, V as VisitorRetry, b as ChangesExpiredReason } from './index-BBp8_tn9.js';
+export { i as ActiveSandbox, aS as AdhocQuery, aT as AdhocRecord, aQ as AggregateMetric, A as AnySchemaDefinition, m as ApiMethod, l as ApiPath, n as ApiSuccessBody, a$ as AssetClient, b8 as AssetEntryResponse, b0 as AssetFileBuilder, b6 as AssetFileExtracted, b9 as AssetFileWhere, bi as AssetPlacement, b1 as AssetUploadBuilder, b3 as AssetVisibility, as as AutocompleteOptions, an as AutocompleteResponse, am as AutocompleteSuggestion, aI as BatchBody, aJ as BatchCreate, aM as BatchDelete, aP as BatchDeleteTarget, aD as BatchOperationResult, aL as BatchReplace, aF as BatchResponse, aN as BatchSingletonWrite, aE as BatchSummary, aO as BatchTarget, aK as BatchUpdate, aG as BatchWrite, aH as BatchWriteOptions, y as ChangesHeadOptions, z as ChangesOptions, aa as ChildEntry, a0 as ChildrenListOptions, $ as ChildrenOptions, ab as ChildrenRead, e as ClientDefaults, f as ClientSchema, bd as ConfirmInput, be as ConfirmResult, I as ContentClient, bh as CreateAssetOptions, J as CreateEntryOptions, s as DefaultRetryPolicy, g as DeployedContentType, D as DeployedLocale, U as DocumentFields, a1 as DocumentReadOptions, X as DocumentVersion, Y as DocumentVersionRow, Z as DocumentVersionsOptions, _ as DocumentWriteOptions, a2 as EntryList, K as EntryPlacement, N as EntryWriteOptions, F as FeedChange, a3 as FieldKey, b5 as FileBackend, bu as FileErrorCode, b4 as FileStatus, b7 as FileStatusResult, bw as FileUploadError, bv as FileUploadErrorCode, by as FileValidationConstraints, bx as FileValidationError, a4 as FreshOption, a5 as GetOptions, H as Health, j as HttpClient, B as LIVE_KEEPALIVE_INTERVAL_MS, E as LIVE_SOCKET_OPEN_TIMEOUT_MS, a6 as ListAllOptions, a7 as ListOptions, G as LiveChangesOptions, L as LocaleCodeOf, a8 as LocaleOption, M as MatchRouteOptions, bl as MultipartCreateResult, bm as MultipartPart, bn as MultipartTarget, aU as NamedQueryOptions, aV as NamedQueryParams, a9 as Paging, ba as PopulatedAssetReference, bb as PresignInput, bc as PresignResult, P as Project, aW as QueryAggregate, aX as QueryAnswer, aY as QueryCall, aR as QueryMetadata, aZ as QueryName, a_ as QueryTypeName, ac as ReadAs, q as ReadEntry, ae as ReadLocale, R as Register, h as RegisteredSchema, bf as ResolveUrlInput, bg as ResolveUrlResult, bq as ResourceConflictError, br as ResourceExpiredError, bp as ResourceNotFoundError, w as RetryPolicy, x as RetryableRequest, r as RetryableWriteOptions, p as RouteMatch, S as SandboxState, ar as SearchEntry, at as SearchFacet, au as SearchFieldKey, av as SearchHighlight, ak as SearchHitMetadata, aw as SearchOptions, ax as SearchPage, al as SearchResponse, aj as SearchResultItem, ay as SearchScope, az as SearchSelected, aA as SearchSortOption, aq as SearchTypeName, aB as SearchWhere, k as SendOptions, Q as SettingsClient, aC as SimilarOptions, ap as SimilarResponse, ao as SimilarResult, O as SingletonClient, af as SortOption, d as TypedClientConfig, T as TypedRelyIOClient, bj as UpdateAssetOptions, bo as UploadProgress, ag as VersionOptions, bk as WaitUntilReadyOptions, W as Wire, ad as WithChildren, ah as WrittenReadScope, ai as WrittenSort, c as createClient, c as default, b2 as isAssetEntry, bt as isMissingEntry, t as isReplaySafe, bs as isResourceNotFound, o as matchRoute, u as retryPolicyFor, bz as validateFile, v as versionCheckOf } from './index-BBp8_tn9.js';
 export { fields } from './schema/index.js';
-import { cl as SDKError, aM as EntryMetadata } from './define-content-type-Ds5rCAYl.js';
-export { aH as AnyDeclaredFieldset, cS as ApiResponse, cq as AssetFileBlock, ak as AssetReading, b2 as AssetServedBlocks, a$ as AssetTypeDefinition, cr as AssetUrls, cs as BaseContent, B as BaseFieldConfig, cu as BaseSettingsGroup, ct as BaseSingleton, cY as BaseValidationError, ai as BlockOf, cO as CacheConfig, cU as CacheStrategy, am as CheckInclude, al as CheckedIncludes, an as ContentReading, aL as ContentTypeDefinition, cG as ContentTypeSchema, cA as CreateInput, cF as CustomQuery, cz as DateOnlyOperator, cQ as DebugConfig, aG as DeclaredFieldset, cW as Environment, h as FieldDefinition, aJ as FieldMember, cJ as FieldOptions, i as FieldRule, ac as FieldSchemaContext, j as FieldType, cH as FieldTypeName, k as FieldUIConfig, ad as FieldValue, ae as FieldValues, aF as Fieldset, b5 as FileKindConfig, bj as FileScanConfig, bi as FileUploadConfig, bb as ImageExifConfig, b3 as ImageKindConfig, ba as ImageSourceConfig, b9 as ImageUploadConfig, ao as IncludablePaths, b1 as InferAssetEntry, b0 as InferAssetType, aN as InferContentType, ca as InferJsonSchema, aT as InferSingleton, c_ as InvalidPayloadError, cb as JsonFieldValue, cc as JsonSchema, cd as JsonValue, ah as Keyed, a_ as KeyedAssetTypeConfig, aK as KeyedContentTypeConfig, K as KeyedEnumConfig, l as KeyedField, m as KeyedFieldOptions, aI as KeyedFieldsetConfig, aV as KeyedSettingsGroupConfig, aQ as KeyedSingletonConfig, co as LiveWebSocket, cp as LiveWebSocketConstructor, aO as LocalePublicationFields, r as LocalizationConfig, s as Localized, t as LocalizedDetails, cV as LogLevel, cN as PerformanceMetrics, aq as ReadWith, ap as Reading, cP as RealtimeConfig, cL as RealtimeEvent, cK as RealtimeEventType, cm as RelyIOConfig, cn as RelyIOConfigUpdate, cR as RequestConfig, cC as RestoredContent, cT as RetryConfig, cB as RevisedContent, aW as SettingsGroupDefinition, ar as SettingsReading, aj as ShapeValue, cE as SingletonContent, aR as SingletonContentTypeDefinition, aS as SingletonMetadata, as as SingletonReading, cM as SubscriptionOptions, ag as UnresolvedEntry, at as UntypedReading, cD as UpdateInput, cZ as ValidationError, cI as ValidationRule, cX as ValidationViolation, bc as VariantDefinition, bf as VideoCaptionsConfig, bg as VideoDownloadConfig, b4 as VideoKindConfig, be as VideoPosterConfig, bd as VideoUploadConfig, bh as VideoWatermarkConfig, cx as WhereClause, cw as WhereFieldCondition, cy as WhereOperator, cv as WhereScalar, W as WidgetOptions, aZ as defineAssetType, aD as defineContentType, aU as defineSettingsGroup, aP as defineSingleton, aE as fieldset } from './define-content-type-Ds5rCAYl.js';
-import { VisitorRetry } from './live-visitor.js';
+import { cl as SDKError, aM as EntryMetadata } from './define-content-type-BGoQxqLf.js';
+export { aH as AnyDeclaredFieldset, cV as ApiResponse, cq as AssetFileBlock, ak as AssetReading, b2 as AssetServedBlocks, a$ as AssetTypeDefinition, cr as AssetUrls, cs as BaseContent, B as BaseFieldConfig, cu as BaseSettingsGroup, ct as BaseSingleton, c$ as BaseValidationError, ai as BlockOf, cS as CacheConfig, cX as CacheStrategy, am as CheckInclude, al as CheckedIncludes, an as ContentReading, aL as ContentTypeDefinition, cL as ContentTypeSchema, cG as ContentVersion, cH as ContentVersionRow, cA as CreateInput, cB as CreatedContent, cK as CustomQuery, cz as DateOnlyOperator, cT as DebugConfig, aG as DeclaredFieldset, cZ as Environment, h as FieldDefinition, aJ as FieldMember, cN as FieldOptions, i as FieldRule, ac as FieldSchemaContext, j as FieldType, k as FieldUIConfig, ad as FieldValue, ae as FieldValues, aF as Fieldset, b5 as FileKindConfig, bj as FileScanConfig, bi as FileUploadConfig, bb as ImageExifConfig, b3 as ImageKindConfig, ba as ImageSourceConfig, b9 as ImageUploadConfig, ao as IncludablePaths, b1 as InferAssetEntry, b0 as InferAssetType, aN as InferContentType, ca as InferJsonSchema, aT as InferSingleton, d1 as InvalidPayloadError, cb as JsonFieldValue, cc as JsonSchema, cd as JsonValue, ah as Keyed, a_ as KeyedAssetTypeConfig, aK as KeyedContentTypeConfig, K as KeyedEnumConfig, l as KeyedField, m as KeyedFieldOptions, aI as KeyedFieldsetConfig, aV as KeyedSettingsGroupConfig, aQ as KeyedSingletonConfig, co as LiveWebSocket, cp as LiveWebSocketConstructor, aO as LocalePublicationFields, r as LocalizationConfig, s as Localized, t as LocalizedDetails, cY as LogLevel, cR as PerformanceMetrics, aq as ReadWith, ap as Reading, cP as RealtimeEvent, cO as RealtimeEventType, cm as RelyIOConfig, cn as RelyIOConfigUpdate, cU as RequestConfig, cF as RestoredContent, cW as RetryConfig, cC as RevisedContent, aW as SettingsGroupDefinition, ar as SettingsReading, aj as ShapeValue, cJ as SingletonContent, aR as SingletonContentTypeDefinition, aS as SingletonMetadata, as as SingletonReading, cQ as SubscriptionOptions, ag as UnresolvedEntry, at as UntypedReading, cI as UpdateInput, d0 as ValidationError, cM as ValidationRule, c_ as ValidationViolation, bc as VariantDefinition, bf as VideoCaptionsConfig, bg as VideoDownloadConfig, b4 as VideoKindConfig, be as VideoPosterConfig, bd as VideoUploadConfig, bh as VideoWatermarkConfig, cx as WhereClause, cw as WhereFieldCondition, cy as WhereOperator, cv as WhereScalar, W as WidgetOptions, cE as WrittenSettingsGroup, cD as WrittenSingleton, aZ as defineAssetType, aD as defineContentType, au as defineLocale, aU as defineSettingsGroup, aP as defineSingleton, aE as fieldset } from './define-content-type-BGoQxqLf.js';
 export { camelToSnake, createDeferred, debounce, deepClone, generateId, isBrowser, isNode, isPlainObject, isValidEmail, isValidUrl, mergeDeep, omit, pick, retry, sleep, snakeToCamel, throttle, toSafeString } from './utils/index.js';
-export { n as RICH_TEXT_VOID_TAGS, R as RelyIOFieldAttributes, a as RelyIOFieldName, b as RelyIOFieldPath, c as RelyIOKeyed, q as RichTextAnchorsOption, t as RichTextAttributes, u as RichTextBlocksOf, v as RichTextDeclaredOf, w as RichTextDeclaredWriters, x as RichTextEntryLinkOf, y as RichTextEntryLinkOption, j as RichTextHtmlDeclaredWriters, k as RichTextHtmlFieldOption, l as RichTextHtmlOptions, z as RichTextInlineOf, m as RichTextMarkdownOptions, A as RichTextNodeContext, B as RichTextRenderable, C as RichTextRenderableOf, D as RichTextReplaceableNode, E as RichTextTag, F as RichTextTarget, e as entryHeadingAnchors, g as escapeHtml, o as isDeclaredRichTextNode, r as relyioField, p as renderRichText, d as richTextHeadingAnchors, f as richTextHeadingSlug, h as richTextToHtml, i as richTextToMarkdown, s as safeRichTextHref } from './index-Db3_tmYf.js';
-export { A as AggregateBlock, L as AnyQueryParameters, M as DeclaredParameters, n as FetchBlock, w as FilterDefinition, I as IncludeDefinition, J as InferQueryParams, G as InferQueryResponse, Q as QueryConfig, l as QueryDefinition, K as QueryParameterValue, h as SchemaAssetTypeNames, S as SchemaConfig, b as SchemaContentTypeNames, a as SchemaDefinition, i as SchemaEntry, j as SchemaEntryOf, f as SchemaLocaleCodes, e as SchemaQueryNames, g as SchemaSettingsGroupNames, c as SchemaSingletonNames, o as SearchBlock, v as SelectMapping, s as SortCondition, W as WhereCondition, k as defineQuery, d as defineSchema } from './define-schema-CxpIYFFR.js';
+export { n as RICH_TEXT_VOID_TAGS, R as RelyIOFieldAttributes, a as RelyIOFieldName, b as RelyIOFieldPath, c as RelyIOKeyed, q as RichTextAnchorsOption, t as RichTextAttributes, u as RichTextBlocksOf, v as RichTextDeclaredOf, w as RichTextDeclaredWriters, x as RichTextEntryLinkOf, y as RichTextEntryLinkOption, j as RichTextHtmlDeclaredWriters, k as RichTextHtmlFieldOption, l as RichTextHtmlOptions, z as RichTextInlineOf, m as RichTextMarkdownOptions, A as RichTextNodeContext, B as RichTextRenderable, C as RichTextRenderableOf, D as RichTextReplaceableNode, E as RichTextTag, F as RichTextTarget, e as entryHeadingAnchors, g as escapeHtml, o as isDeclaredRichTextNode, r as relyioField, p as renderRichText, d as richTextHeadingAnchors, f as richTextHeadingSlug, h as richTextToHtml, i as richTextToMarkdown, s as safeRichTextHref } from './index-DaMZ4FQ_.js';
+export { A as AggregateBlock, L as AnyQueryParameters, M as DeclaredParameters, n as FetchBlock, w as FilterDefinition, I as IncludeDefinition, J as InferQueryParams, G as InferQueryResponse, Q as QueryConfig, l as QueryDefinition, K as QueryParameterValue, h as SchemaAssetTypeNames, S as SchemaConfig, b as SchemaContentTypeNames, a as SchemaDefinition, i as SchemaEntry, j as SchemaEntryOf, f as SchemaLocaleCodes, e as SchemaQueryNames, g as SchemaSettingsGroupNames, c as SchemaSingletonNames, o as SearchBlock, v as SelectMapping, s as SortCondition, W as WhereCondition, k as defineQuery, d as defineSchema } from './define-schema-DgCX9YB7.js';
 export { e as RichTextBlock, f as RichTextCellAlignment, g as RichTextCodeBlock, h as RichTextCodeGroup, i as RichTextCodeLines, j as RichTextDivider, d as RichTextEntryLinkMark, k as RichTextHeading, l as RichTextInline, m as RichTextLineBreak, n as RichTextLinkMark, o as RichTextList, p as RichTextListItem, q as RichTextListStyle, r as RichTextMark, s as RichTextMarkType, t as RichTextNode, u as RichTextParagraph, v as RichTextQuote, w as RichTextSpan, x as RichTextStructure, y as RichTextTable, z as RichTextTableCell, B as RichTextTableRow, b as RichTextValue } from './rich-text.d-BWc-5gX1.js';
 import './dev-handshake/index.js';
 
@@ -35,6 +34,18 @@ declare const PUBLISHABLE_KEY_PREFIX = "rly_pub_";
  * publishable key, so the answer is `false` rather than a `TypeError` in a caller that only asked.
  */
 declare const isPublishableKey: (apiKey: string | undefined) => boolean;
+/**
+ * A preview key's prefix: scope `prev`, the one project key that reads drafts and the only kind a
+ * client sends a pull request's preview dataset with (`github-integration-spec.md` decision 14).
+ * Restated from the service's `isPreviewApiKey` and held to it by `src/__tests__/key-kind.test.ts`,
+ * as the publishable prefix is.
+ */
+declare const PREVIEW_KEY_PREFIX = "rly_prev_";
+/**
+ * Whether `apiKey` is a preview key (`rly_prev_…`). It reads the prefix only, as
+ * {@link isPublishableKey} does; `undefined` — a client holding no key — is not one.
+ */
+declare const isPreviewKey: (apiKey: string | undefined) => boolean;
 
 /**
  * `followChanges()` — the one loop that follows a changes source until its
@@ -432,9 +443,13 @@ declare class PayloadTooLargeError extends SDKError {
     getUserMessage(): string;
 }
 /**
- * `TRANSACTION_ROLLED_BACK` — an atomic batch failed at one member and nothing
- * was written. `failedIndex` is which one, so a caller can fix that operation
- * rather than re-sending the whole batch blind.
+ * `TRANSACTION_ROLLED_BACK` — an atomic batch failed and nothing was written.
+ *
+ * `failedIndex` is the index, in the batch, of the operation this refusal was
+ * served for. The service sends each rolled-back item its **own** index, so it
+ * does not say which operation caused the rollback: read it as "this is
+ * operation N", never "operation N failed". Find the cause among the batch's
+ * results, not here.
  */
 declare class TransactionRolledBackError extends SDKError {
     readonly code = "TRANSACTION_ROLLED_BACK";
@@ -552,11 +567,6 @@ declare class LiveEdgeError extends SDKError {
         readonly retryAfterMs?: number;
         readonly context?: Record<string, unknown>;
     });
-    /**
-     * 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: Record<string, unknown>): this;
     getUserMessage(): string;
 }
 
@@ -972,4 +982,4 @@ declare function snapToLadder(value: number): number;
 
 declare const VERSION = "__VERSION__";
 
-export { AuthorizationError, Change, type ChangeSource, type ChangeSourceOptions, ChangesExpiredError, ChangesExpiredReason, ConnectionError, EntryMetadata, ErrorMapper, FOLLOW_BACK_OFF_MAX_MS, FOLLOW_RETRY_BASE_MS, FOLLOW_RETRY_MAX_MS, type FollowEnd, type FollowOptions, type FollowResync, type FollowState, type FollowVerdict, IMAGE_LADDER, InvalidApiKeyError, type KeyPathSegment, type LanguageSwitcherOption, type LanguageSwitcherOptions, type LiveEdgeEnd, LiveEdgeError, type LocaleMetadata, type LocaleStatus, type LocalizedEntry, MethodNotAllowedError, MissingApiKeyError, NetworkError, PUBLISHABLE_KEY_PREFIX, PayloadTooLargeError, PlanFeatureUnavailableError, RELYIO_CHANGE_EVENT, RELYIO_RESYNC_EVENT, RateLimitError, ReadOnlyKeyError, type RelyIOChangeDetail, type RelyIOResyncDetail, SDKError, ServerError, ServiceIndeterminateError, TimeoutError, TransactionRolledBackError, type TranslationCompleteness, UnknownContractError, UsageQuotaExceededError, VERSION, buildLanguageSwitcher, classifyFollowFailure, estimateTranslationCompleteness, followChanges, formatKeyPath, getAllLocalizedValues, getAvailableLocaleCodes, getDefaultLocale, getFallbackFields, getFieldFallbackLocale, getLocalizedField, getPublishedLocaleCodes, getRequestedLocale, hasLocale, isFieldFallback, isPublishableKey, isPublishedInLocale, localeHelpers, needsTranslation, parseKeyPath, snapToLadder };
+export { AuthorizationError, Change, type ChangeSource, type ChangeSourceOptions, ChangesExpiredError, ChangesExpiredReason, ConnectionError, EntryMetadata, ErrorMapper, FOLLOW_BACK_OFF_MAX_MS, FOLLOW_RETRY_BASE_MS, FOLLOW_RETRY_MAX_MS, type FollowEnd, type FollowOptions, type FollowResync, type FollowState, type FollowVerdict, IMAGE_LADDER, InvalidApiKeyError, type KeyPathSegment, type LanguageSwitcherOption, type LanguageSwitcherOptions, type LiveEdgeEnd, LiveEdgeError, type LocaleMetadata, type LocaleStatus, type LocalizedEntry, MethodNotAllowedError, MissingApiKeyError, NetworkError, PREVIEW_KEY_PREFIX, PUBLISHABLE_KEY_PREFIX, PayloadTooLargeError, PlanFeatureUnavailableError, RELYIO_CHANGE_EVENT, RELYIO_RESYNC_EVENT, RateLimitError, ReadOnlyKeyError, type RelyIOChangeDetail, type RelyIOResyncDetail, SDKError, ServerError, ServiceIndeterminateError, TimeoutError, TransactionRolledBackError, type TranslationCompleteness, UnknownContractError, UsageQuotaExceededError, VERSION, buildLanguageSwitcher, classifyFollowFailure, estimateTranslationCompleteness, followChanges, formatKeyPath, getAllLocalizedValues, getAvailableLocaleCodes, getDefaultLocale, getFallbackFields, getFieldFallbackLocale, getLocalizedField, getPublishedLocaleCodes, getRequestedLocale, hasLocale, isFieldFallback, isPreviewKey, isPublishableKey, isPublishedInLocale, localeHelpers, needsTranslation, parseKeyPath, snapToLadder };