@relyio/sdk 0.12.0 → 0.14.0

package/dist/index.d.cts

@@ -1,15 +1,13 @@
-import { C as Change, a as ChangesExpiredError, b as ChangesExpiredReason } from './index-BrvEg6-A.cjs';
-export { A as ActiveSandbox, a6 as AdhocAggregateBlock, a5 as AdhocFetchBlock, a4 as AdhocQueryBuilder, a3 as AdhocQueryClient, ab as AdhocQueryDefinition, ac as AdhocQueryOptions, ae as AdhocQueryResult, a8 as AdhocSearchBlock, a7 as AggregateMetric, af as AssetClient, aq as AssetEntryResponse, am as AssetFileBlock, ag as AssetFileBuilder, an as AssetFileExtracted, ah as AssetUploadBuilder, ap as AssetUrls, aj as AssetVisibility, y as AutocompleteBuilder, K as AutocompleteResponse, J as AutocompleteSuggestion, Y as BatchBuilder, X as BatchClient, Z as BatchMethod, _ as BatchOperation, a0 as BatchOperationResult, $ as BatchOptions, a2 as BatchResponse, a1 as BatchSummary, k as ChangesHeadOptions, l as ChangesOptions, t as ChildrenOptions, e as ClientSchema, i as ConditionalWriteOptions, au as ConfirmInput, av as ConfirmResult, s as ContentByIdBuilder, o as ContentClient, r as ContentQueryBuilder, ay as CreateAssetOptions, E as ExtendedQueryResult, F as FeedChange, al as FileBackend, aI as FileErrorCode, ak as FileStatus, ao as FileStatusResult, aK as FileUploadError, aJ as FileUploadErrorCode, aM as FileValidationConstraints, aL as FileValidationError, a9 as FilterValue, aa as FullTextConfig, H as HttpClient, L as LIVE_KEEPALIVE_INTERVAL_MS, m as LIVE_SOCKET_OPEN_TIMEOUT_MS, n as LiveChangesOptions, aA as MultipartCreateResult, aB as MultipartPart, aC as MultipartTarget, ar as PopulatedAssetReference, as as PresignInput, at as PresignResult, P as Project, ad as QueryMetadata, R as Register, f as RegisteredSchema, aw as ResolveUrlInput, ax as ResolveUrlResult, aF as ResourceConflictError, aG as ResourceExpiredError, aE as ResourceNotFoundError, j as RetryableWriteOptions, S as SandboxState, x as SearchBuilder, w as SearchClient, W as SearchEntry, Q as SearchFields, O as SearchFilter, G as SearchHitMetadata, B as SearchMode, I as SearchResponse, D as SearchResultItem, U as SearchSort, V as SearchTypeName, g as SendOptions, q as SettingsClient, v as SettingsFetchOptions, z as SimilarBuilder, N as SimilarResponse, M as SimilarResult, p as SingletonClient, u as SingletonFetchOptions, d as TypedClientConfig, T as TypedRelyIOClient, aD as UploadProgress, az as WaitUntilReadyOptions, c as createClient, c as default, h as entityTagOf, ai as isAssetEntry, aH as isResourceNotFound, aN as validateFile } from './index-BrvEg6-A.cjs';
+import { C as Change, a as ChangesExpiredError, b as ChangesExpiredReason } from './index-DgVV5Nj7.cjs';
+export { i as ActiveSandbox, aH as AdhocQuery, aI as AdhocRecord, aF as AggregateMetric, A as AnySchemaDefinition, m as ApiMethod, l as ApiPath, n as ApiSuccessBody, aQ as AssetClient, aZ as AssetEntryResponse, aR as AssetFileBuilder, aX as AssetFileExtracted, b6 as AssetPlacement, aS as AssetUploadBuilder, aU as AssetVisibility, ah as AutocompleteOptions, ac as AutocompleteResponse, ab as AutocompleteSuggestion, ax as BatchBody, ay as BatchCreate, aB as BatchDelete, aE as BatchDeleteTarget, as as BatchOperationResult, aA as BatchReplace, au as BatchResponse, aC as BatchSingletonWrite, at as BatchSummary, aD as BatchTarget, az as BatchUpdate, av as BatchWrite, aw as BatchWriteOptions, s as ChangesHeadOptions, t as ChangesOptions, Q as ChildrenOptions, e as ClientDefaults, f as ClientSchema, b1 as ConfirmInput, b2 as ConfirmResult, y as ContentClient, b5 as CreateAssetOptions, z as CreateEntryOptions, g as DeployedContentType, D as DeployedLocale, J as DocumentFields, U as DocumentReadOptions, K as DocumentVersion, N as DocumentVersionsOptions, O as DocumentWriteOptions, V as EntryList, E as EntryPlacement, B as EntryWriteOptions, F as FeedChange, X as FieldKey, aW as FileBackend, bi as FileErrorCode, aV as FileStatus, aY as FileStatusResult, bk as FileUploadError, bj as FileUploadErrorCode, bm as FileValidationConstraints, bl as FileValidationError, Y as FreshOption, Z as GetOptions, H as Health, j as HttpClient, u as LIVE_KEEPALIVE_INTERVAL_MS, w as LIVE_SOCKET_OPEN_TIMEOUT_MS, _ as ListAllOptions, $ as ListOptions, x as LiveChangesOptions, L as LocaleCodeOf, a0 as LocaleOption, M as MatchRouteOptions, b9 as MultipartCreateResult, ba as MultipartPart, bb as MultipartTarget, aJ as NamedQueryOptions, aK as NamedQueryParams, a1 as Paging, a_ as PopulatedAssetReference, a$ as PresignInput, b0 as PresignResult, P as Project, aL as QueryAggregate, aM as QueryAnswer, aN as QueryCall, aG as QueryMetadata, aO as QueryName, aP as QueryTypeName, a2 as ReadAs, q as ReadEntry, a3 as ReadLocale, R as Register, h as RegisteredSchema, b3 as ResolveUrlInput, b4 as ResolveUrlResult, be as ResourceConflictError, bf as ResourceExpiredError, bd as ResourceNotFoundError, r as RetryableWriteOptions, p as RouteMatch, S as SandboxState, ag as SearchEntry, ai as SearchFacet, aj as SearchFieldKey, ak as SearchHighlight, a9 as SearchHitMetadata, al as SearchOptions, am as SearchPage, aa as SearchResponse, a8 as SearchResultItem, an as SearchScope, ao as SearchSelected, ap as SearchSortOption, af as SearchTypeName, aq as SearchWhere, k as SendOptions, I as SettingsClient, ar as SimilarOptions, ae as SimilarResponse, ad as SimilarResult, G as SingletonClient, a4 as SortOption, d as TypedClientConfig, T as TypedRelyIOClient, b7 as UpdateAssetOptions, bc as UploadProgress, a5 as VersionOptions, b8 as WaitUntilReadyOptions, W as Wire, a6 as WrittenReadScope, a7 as WrittenSort, c as createClient, c as default, aT as isAssetEntry, bh as isMissingEntry, bg as isResourceNotFound, o as matchRoute, bn as validateFile, v as versionCheckOf } from './index-DgVV5Nj7.cjs';
 export { fields } from './schema/index.cjs';
-import { S as SDKError, B as BaseContent } from './index-b-AkfTUv.cjs';
-export { c as ApiMethod, A as ApiPath, w as ApiResponse, d as ApiSuccessBody, H as BaseValidationError, t as CacheConfig, y as CacheStrategy, k as ContentQueryResult, o as ContentTypeSchema, C as CreateInput, n as CustomQuery, D as DebugConfig, E as Environment, p as FieldOptions, F as FieldTypeName, J as InvalidPayloadError, L as LiveWebSocket, b as LiveWebSocketConstructor, z as LogLevel, M as MatchRouteOptions, P as PerformanceMetrics, Q as QueryOptions, u as RealtimeConfig, r as RealtimeEvent, q as RealtimeEventType, R as RelyIOConfig, a as RelyIOConfigUpdate, v as RequestConfig, x as RetryConfig, e as RouteMatch, l as SingletonContent, j as SortOptions, s as SubscriptionOptions, U as UpdateInput, I as ValidationError, V as ValidationRule, G as ValidationViolation, h as WhereClause, g as WhereFieldCondition, i as WhereOperator, f as WhereScalar, W as Wire, m as matchRoute } from './index-b-AkfTUv.cjs';
+import { cl as SDKError, aM as EntryMetadata } from './define-content-type-BUZeWtpk.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-BUZeWtpk.cjs';
 import { VisitorRetry } from './live-visitor.js';
 export { camelToSnake, createDeferred, debounce, deepClone, generateId, isBrowser, isNode, isPlainObject, isValidEmail, isValidUrl, mergeDeep, omit, pick, retry, sleep, snakeToCamel, throttle, toSafeString } from './utils/index.cjs';
-import { a5 as EntryMetadata } from './include-paths-CL4gHv6I.cjs';
-export { J as AssetReading, al as AssetTypeConfig, am as AssetTypeDefinition, o as BaseFieldConfig, G as BlockOf, N as CheckInclude, M as CheckedIncludes, P as ContentReading, a3 as ContentTypeConfig, a4 as ContentTypeDefinition, c as FieldDefinition, a2 as FieldMember, b as FieldRule, v as FieldSchemaContext, p as FieldType, F as FieldUIConfig, w as FieldValue, x as FieldValues, a1 as Fieldset, aq as FileKindConfig, aE as FileScanConfig, aD as FileUploadConfig, aw as ImageExifConfig, ao as ImageKindConfig, av as ImageSourceConfig, au as ImageUploadConfig, Q as IncludablePaths, an as InferAssetType, a6 as InferContentType, ae as InferSingleton, ad as InferSingletonContentType, K as Keyed, a7 as LocalePublicationFields, L as LocalizationConfig, X as ReadWith, W as Reading, ag as SettingsGroupConfig, ah as SettingsGroupDefinition, Y as SettingsReading, H as ShapeValue, ab as SingletonContentTypeDefinition, ac as SingletonMetadata, Z as SingletonReading, z as UnresolvedEntry, _ as UntypedReading, ax as VariantDefinition, aA as VideoCaptionsConfig, aB as VideoDownloadConfig, ap as VideoKindConfig, az as VideoPosterConfig, ay as VideoUploadConfig, aC as VideoWatermarkConfig, ak as defineAssetType, $ as defineContentType, af as defineSettingsGroup, a9 as defineSingleton, a8 as defineSingletonContentType, a0 as fieldset } from './include-paths-CL4gHv6I.cjs';
-export { RICH_TEXT_VOID_TAGS, RichTextAttributes, RichTextNodeContext, RichTextRenderable, RichTextReplaceableNode, RichTextTag, RichTextTarget, renderRichText, richTextToHtml, richTextToMarkdown, safeRichTextHref } from './rich-text/index.cjs';
-export { _ as AggregateBlock, Z as FetchBlock, aa as FilterDefinition, a7 as IncludeDefinition, ak as InferQueryParams, aj as InferQueryResponse, U as QueryConfig, W as QueryDefinition, 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, $ as SearchBlock, a9 as SelectMapping, a5 as SortCondition, a0 as WhereCondition, Q as defineQuery, d as defineSchema } from './define-schema-DgctHlI2.cjs';
-export { R as RichTextBlock, a as RichTextCellAlignment, b as RichTextCodeBlock, c as RichTextCodeGroup, d as RichTextCodeLines, e as RichTextDivider, f as RichTextHeading, g as RichTextInline, h as RichTextLineBreak, i as RichTextLinkMark, j as RichTextList, k as RichTextListItem, l as RichTextListStyle, m as RichTextMark, n as RichTextMarkType, o as RichTextNode, p as RichTextParagraph, q as RichTextQuote, r as RichTextSpan, s as RichTextStructure, t as RichTextTable, u as RichTextTableCell, v as RichTextTableRow, w as RichTextValue } from './rich-text.d-rKmpgdGd.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-C-pcllqY.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-nCfZeboB.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';
 
 /**
@@ -687,10 +685,7 @@ interface TranslationCompleteness {
  *
  * @example
  * ```typescript
- * const product = await client.content('product')
- *   .findById('prod_123')
- *   .locale('de-DE')
- *   .execute()
+ * const product = await client.content('product').get('prod_123', { locale: 'de-DE' })
  *
  * if (localeHelpers.needsTranslation(product)) {
  *   showTranslationBadge()
@@ -776,10 +771,7 @@ declare function estimateTranslationCompleteness(entry: LocalizedEntry, localize
  *
  * @example
  * ```typescript
- * const entry = await client.content('product')
- *   .findById('prod_123')
- *   .allLocales()
- *   .execute()
+ * const entry = await client.content('product').get('prod_123', { locale: '*' })
  *
  * const spanishTitle = localeHelpers.getLocalizedField(entry, 'title', 'es-ES')
  * ```
@@ -816,70 +808,41 @@ declare const localeHelpers: {
 };
 
 /**
- * The DOM↔field binding contract, as the one pure helper that emits it.
- *
- * Spread onto the element that renders a field, it stamps which entry, content type, field and
- * locale produced that element, so an editing surface can find the field by scanning the DOM
- * rather than by guessing (`INV-TB-BINDING`). The contract is `toolbar-spec.md` §DOM↔field; this
- * file is its only implementation.
- *
- * **Frozen** (`INV-SS-BINDING-FROZEN`). The attribute set is exactly the five below. Adding,
- * renaming or dropping one is a new contract, and a new contract is a bump of `data-relyio-v` — a
- * page built against version 1 keeps being read as version 1 by any surface that scans it.
- *
- * **Pure** (`INV-TB-SDK-PURE`). It reads the entry it is handed and returns attributes. It imports
- * nothing but the SDK's own types: no realtime, no AI, no first-party code, no framework. That is
- * what lets it live in the customer SDK and run on a server render as happily as in a browser.
- *
- * **Every value comes from the entry.** The id, the content type and the locale are the ones the
- * API reported in `_metadata` — the locale is the one the payload's field values were composed
- * for. There is deliberately no `locale` argument: a caller-supplied locale could bind a node to a
- * locale whose value it is not rendering, which is the silently inferred binding `INV-TB-BINDING`
- * forbids.
- */
-
-/** The version of the binding contract this helper emits. */
-declare const BINDING_VERSION = "1";
-/** The attributes `relyioField` returns — the whole of binding contract version 1. */
-interface RelyIOFieldAttributes {
-    /** The entry's id (`_metadata.id`). */
-    readonly 'data-relyio-entry': string;
-    /** The entry's content type (`_metadata.type`); every customer read is keyed by it. */
-    readonly 'data-relyio-type': string;
-    /** The field the element renders. */
-    readonly 'data-relyio-field': string;
-    /** The locale the entry's field values were composed for (`_metadata.locale`). */
-    readonly 'data-relyio-locale': string;
-    /** The binding contract's version. */
-    readonly 'data-relyio-v': typeof BINDING_VERSION;
-}
+ * A key path (REL-1814): where a value sits inside an entry, each item on the way named by its
+ * `_key` — `sections[_key=="f2k6ub9s"].heading`. A field by its id (`title`), a field of an object's
+ * value after the object's (`hero.title`), an item of a list by its key (`faq[_key=="k1"]`) and a
+ * field of that item after it (`faq[_key=="k1"].question`), to any depth. Inside a rich-text field a
+ * key names a declared Block or Inline element wherever it stands in the tree (`body[_key=="c1"]`):
+ * a key is unique within the field, nested trees included, so the path needs no step for the quote
+ * or the list item around it, and a field of the node follows it (`body[_key=="c1"].caption`).
+ *
+ * It is the spelling a validation error's path, a live binding, a comment's anchor and a filled
+ * field's path already use, so the address a page stamps is the one the Studio opens a field by,
+ * and it stays on its item when the list is reordered — which an index would not. The rule is
+ * `@relyio/schema`'s `formatItemPath` and `parseKeyedPath`, restated here because this package takes
+ * no runtime from that one (it is build-inlined for types only); `devtools/verification`'s
+ * `key-paths-sdk.test.ts` holds the two to one corpus.
+ */
+/** One step of a key path: a field by its id, or the item of the list (or rich text) before it. */
+type KeyPathSegment = {
+    readonly field: string;
+} | {
+    readonly key: string;
+};
 /**
- * The field names `relyioField` accepts for an entry of type `T`.
- *
- * A schema-typed entry narrows to its declared field names, so they autocomplete and a misspelt
- * one does not compile. An entry with no declared fields — `BaseContent`, which is what an
- * un-generated client returns — has none to narrow to, and `keyof` of it is `never`; that would
- * make the helper uncallable for every untyped customer, so it accepts any field name instead.
+ * The key path of an item of the list at `listPath` — `faq[_key=="k1"]` — or of a field inside it
+ * when `field` is given: `faq[_key=="k1"].question`. The key is written as a JSON string, so a quote
+ * in it stays inside it. `listPath` and `field` are key paths of their own (`sections[_key=="a"].links`,
+ * `link.label`).
  */
-type RelyIOFieldName<T extends BaseContent> = [Exclude<keyof T, '_metadata'>] extends [never] ? string : string & Exclude<keyof T, '_metadata'>;
+declare function formatKeyPath(listPath: string, key: string, field?: string): string;
 /**
- * Binding attributes for one field of one entry.
- *
- * @example
- * ```tsx
- * import { relyioField } from '@relyio/sdk'
- *
- * <h1 {...relyioField(post, 'title')}>{post.title}</h1>
- * // → data-relyio-entry="6710f…" data-relyio-type="post" data-relyio-field="title"
- * //   data-relyio-locale="en-US" data-relyio-v="1"
- * ```
- *
- * @throws {TypeError} when the entry's `_metadata` lacks its id, content type or locale. Every
- * entry the API returns carries all three, so this is reached only by a value that was not read
- * from RelyIO. It throws rather than emitting a partial binding: a node stamped with no locale, or
- * none at all, is a binding a surface would have to guess the rest of.
+ * A key path read back into its steps: `sections[_key=="a"].links[_key=="b"].label` → `sections`,
+ * `a`, `links`, `b`, `label`. A path with no item in it is its field ids (`hero.title` → `hero`,
+ * `title`). `null` for anything else — an index (`faq[0]`), an item of an item, an unterminated or
+ * empty key, an empty field id — which names no value by key.
  */
-declare function relyioField<T extends BaseContent>(entry: T, field: RelyIOFieldName<T>): RelyIOFieldAttributes;
+declare function parseKeyPath(path: string): KeyPathSegment[] | null;
 
 /**
  * The DOM event a preview surface dispatches when content on the page has changed, and the one
@@ -981,19 +944,18 @@ declare function snapToLadder(value: number): number;
  * ```typescript
  * import { createClient, defineSchema, defineContentType, fields } from '@relyio/sdk'
  *
- * const product = defineContentType('product', {
- *   displayName: 'Product',
- *   fields: [
- *     fields.shortText('title', { config: { required: true } }),
- *     fields.decimal('price', { config: { min: 0, decimalPlaces: 2 } }),
- *   ]
+ * const product = defineContentType({
+ *   fields: {
+ *     title: fields.shortText({ required: true }),
+ *     price: fields.decimal({ min: 0, decimalPlaces: 2 }),
+ *   },
  * })
  *
  * const schema = defineSchema({ contentTypes: { product } })
  * const client = createClient({ apiKey: '...', schema })
  *
  * // Full autocomplete for content types and fields!
- * const products = await client.content('product').query().execute()
+ * const { data: products } = await client.content('product').list({ sort: { price: 'asc' } })
  * ```
  *
  * @example Without schema (dynamic usage)
@@ -1003,11 +965,11 @@ declare function snapToLadder(value: number): number;
  * const client = createClient({ apiKey: '...' })
  *
  * // Works dynamically without type checking
- * const products = await client.content('product').query().execute()
- * const results = await client.search('wireless').in('product').execute()
+ * const { data: products } = await client.content('product').list()
+ * const results = await client.search('wireless', { contentType: 'product' })
  * ```
  */
 
 declare const VERSION = "__VERSION__";
 
-export { AuthorizationError, BaseContent, 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 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 RelyIOFieldAttributes, type RelyIOFieldName, type RelyIOResyncDetail, SDKError, ServerError, ServiceIndeterminateError, TimeoutError, TransactionRolledBackError, type TranslationCompleteness, UnknownContractError, UsageQuotaExceededError, VERSION, buildLanguageSwitcher, classifyFollowFailure, estimateTranslationCompleteness, followChanges, getAllLocalizedValues, getAvailableLocaleCodes, getDefaultLocale, getFallbackFields, getFieldFallbackLocale, getLocalizedField, getPublishedLocaleCodes, getRequestedLocale, hasLocale, isFieldFallback, isPublishableKey, isPublishedInLocale, localeHelpers, needsTranslation, relyioField, 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, 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 };

package/dist/index.d.ts

@@ -1,15 +1,13 @@
-import { C as Change, a as ChangesExpiredError, b as ChangesExpiredReason } from './index-Pw0onkJe.js';
-export { A as ActiveSandbox, a6 as AdhocAggregateBlock, a5 as AdhocFetchBlock, a4 as AdhocQueryBuilder, a3 as AdhocQueryClient, ab as AdhocQueryDefinition, ac as AdhocQueryOptions, ae as AdhocQueryResult, a8 as AdhocSearchBlock, a7 as AggregateMetric, af as AssetClient, aq as AssetEntryResponse, am as AssetFileBlock, ag as AssetFileBuilder, an as AssetFileExtracted, ah as AssetUploadBuilder, ap as AssetUrls, aj as AssetVisibility, y as AutocompleteBuilder, K as AutocompleteResponse, J as AutocompleteSuggestion, Y as BatchBuilder, X as BatchClient, Z as BatchMethod, _ as BatchOperation, a0 as BatchOperationResult, $ as BatchOptions, a2 as BatchResponse, a1 as BatchSummary, k as ChangesHeadOptions, l as ChangesOptions, t as ChildrenOptions, e as ClientSchema, i as ConditionalWriteOptions, au as ConfirmInput, av as ConfirmResult, s as ContentByIdBuilder, o as ContentClient, r as ContentQueryBuilder, ay as CreateAssetOptions, E as ExtendedQueryResult, F as FeedChange, al as FileBackend, aI as FileErrorCode, ak as FileStatus, ao as FileStatusResult, aK as FileUploadError, aJ as FileUploadErrorCode, aM as FileValidationConstraints, aL as FileValidationError, a9 as FilterValue, aa as FullTextConfig, H as HttpClient, L as LIVE_KEEPALIVE_INTERVAL_MS, m as LIVE_SOCKET_OPEN_TIMEOUT_MS, n as LiveChangesOptions, aA as MultipartCreateResult, aB as MultipartPart, aC as MultipartTarget, ar as PopulatedAssetReference, as as PresignInput, at as PresignResult, P as Project, ad as QueryMetadata, R as Register, f as RegisteredSchema, aw as ResolveUrlInput, ax as ResolveUrlResult, aF as ResourceConflictError, aG as ResourceExpiredError, aE as ResourceNotFoundError, j as RetryableWriteOptions, S as SandboxState, x as SearchBuilder, w as SearchClient, W as SearchEntry, Q as SearchFields, O as SearchFilter, G as SearchHitMetadata, B as SearchMode, I as SearchResponse, D as SearchResultItem, U as SearchSort, V as SearchTypeName, g as SendOptions, q as SettingsClient, v as SettingsFetchOptions, z as SimilarBuilder, N as SimilarResponse, M as SimilarResult, p as SingletonClient, u as SingletonFetchOptions, d as TypedClientConfig, T as TypedRelyIOClient, aD as UploadProgress, az as WaitUntilReadyOptions, c as createClient, c as default, h as entityTagOf, ai as isAssetEntry, aH as isResourceNotFound, aN as validateFile } from './index-Pw0onkJe.js';
+import { C as Change, a as ChangesExpiredError, b as ChangesExpiredReason } from './index-DOhFQbv7.js';
+export { i as ActiveSandbox, aH as AdhocQuery, aI as AdhocRecord, aF as AggregateMetric, A as AnySchemaDefinition, m as ApiMethod, l as ApiPath, n as ApiSuccessBody, aQ as AssetClient, aZ as AssetEntryResponse, aR as AssetFileBuilder, aX as AssetFileExtracted, b6 as AssetPlacement, aS as AssetUploadBuilder, aU as AssetVisibility, ah as AutocompleteOptions, ac as AutocompleteResponse, ab as AutocompleteSuggestion, ax as BatchBody, ay as BatchCreate, aB as BatchDelete, aE as BatchDeleteTarget, as as BatchOperationResult, aA as BatchReplace, au as BatchResponse, aC as BatchSingletonWrite, at as BatchSummary, aD as BatchTarget, az as BatchUpdate, av as BatchWrite, aw as BatchWriteOptions, s as ChangesHeadOptions, t as ChangesOptions, Q as ChildrenOptions, e as ClientDefaults, f as ClientSchema, b1 as ConfirmInput, b2 as ConfirmResult, y as ContentClient, b5 as CreateAssetOptions, z as CreateEntryOptions, g as DeployedContentType, D as DeployedLocale, J as DocumentFields, U as DocumentReadOptions, K as DocumentVersion, N as DocumentVersionsOptions, O as DocumentWriteOptions, V as EntryList, E as EntryPlacement, B as EntryWriteOptions, F as FeedChange, X as FieldKey, aW as FileBackend, bi as FileErrorCode, aV as FileStatus, aY as FileStatusResult, bk as FileUploadError, bj as FileUploadErrorCode, bm as FileValidationConstraints, bl as FileValidationError, Y as FreshOption, Z as GetOptions, H as Health, j as HttpClient, u as LIVE_KEEPALIVE_INTERVAL_MS, w as LIVE_SOCKET_OPEN_TIMEOUT_MS, _ as ListAllOptions, $ as ListOptions, x as LiveChangesOptions, L as LocaleCodeOf, a0 as LocaleOption, M as MatchRouteOptions, b9 as MultipartCreateResult, ba as MultipartPart, bb as MultipartTarget, aJ as NamedQueryOptions, aK as NamedQueryParams, a1 as Paging, a_ as PopulatedAssetReference, a$ as PresignInput, b0 as PresignResult, P as Project, aL as QueryAggregate, aM as QueryAnswer, aN as QueryCall, aG as QueryMetadata, aO as QueryName, aP as QueryTypeName, a2 as ReadAs, q as ReadEntry, a3 as ReadLocale, R as Register, h as RegisteredSchema, b3 as ResolveUrlInput, b4 as ResolveUrlResult, be as ResourceConflictError, bf as ResourceExpiredError, bd as ResourceNotFoundError, r as RetryableWriteOptions, p as RouteMatch, S as SandboxState, ag as SearchEntry, ai as SearchFacet, aj as SearchFieldKey, ak as SearchHighlight, a9 as SearchHitMetadata, al as SearchOptions, am as SearchPage, aa as SearchResponse, a8 as SearchResultItem, an as SearchScope, ao as SearchSelected, ap as SearchSortOption, af as SearchTypeName, aq as SearchWhere, k as SendOptions, I as SettingsClient, ar as SimilarOptions, ae as SimilarResponse, ad as SimilarResult, G as SingletonClient, a4 as SortOption, d as TypedClientConfig, T as TypedRelyIOClient, b7 as UpdateAssetOptions, bc as UploadProgress, a5 as VersionOptions, b8 as WaitUntilReadyOptions, W as Wire, a6 as WrittenReadScope, a7 as WrittenSort, c as createClient, c as default, aT as isAssetEntry, bh as isMissingEntry, bg as isResourceNotFound, o as matchRoute, bn as validateFile, v as versionCheckOf } from './index-DOhFQbv7.js';
 export { fields } from './schema/index.js';
-import { S as SDKError, B as BaseContent } from './index-B9RfZVF1.js';
-export { c as ApiMethod, A as ApiPath, w as ApiResponse, d as ApiSuccessBody, H as BaseValidationError, t as CacheConfig, y as CacheStrategy, k as ContentQueryResult, o as ContentTypeSchema, C as CreateInput, n as CustomQuery, D as DebugConfig, E as Environment, p as FieldOptions, F as FieldTypeName, J as InvalidPayloadError, L as LiveWebSocket, b as LiveWebSocketConstructor, z as LogLevel, M as MatchRouteOptions, P as PerformanceMetrics, Q as QueryOptions, u as RealtimeConfig, r as RealtimeEvent, q as RealtimeEventType, R as RelyIOConfig, a as RelyIOConfigUpdate, v as RequestConfig, x as RetryConfig, e as RouteMatch, l as SingletonContent, j as SortOptions, s as SubscriptionOptions, U as UpdateInput, I as ValidationError, V as ValidationRule, G as ValidationViolation, h as WhereClause, g as WhereFieldCondition, i as WhereOperator, f as WhereScalar, W as Wire, m as matchRoute } from './index-B9RfZVF1.js';
+import { cl as SDKError, aM as EntryMetadata } from './define-content-type-DOrZb_a_.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-DOrZb_a_.js';
 import { VisitorRetry } from './live-visitor.js';
 export { camelToSnake, createDeferred, debounce, deepClone, generateId, isBrowser, isNode, isPlainObject, isValidEmail, isValidUrl, mergeDeep, omit, pick, retry, sleep, snakeToCamel, throttle, toSafeString } from './utils/index.js';
-import { a5 as EntryMetadata } from './include-paths-CrJNTsMl.js';
-export { J as AssetReading, al as AssetTypeConfig, am as AssetTypeDefinition, o as BaseFieldConfig, G as BlockOf, N as CheckInclude, M as CheckedIncludes, P as ContentReading, a3 as ContentTypeConfig, a4 as ContentTypeDefinition, c as FieldDefinition, a2 as FieldMember, b as FieldRule, v as FieldSchemaContext, p as FieldType, F as FieldUIConfig, w as FieldValue, x as FieldValues, a1 as Fieldset, aq as FileKindConfig, aE as FileScanConfig, aD as FileUploadConfig, aw as ImageExifConfig, ao as ImageKindConfig, av as ImageSourceConfig, au as ImageUploadConfig, Q as IncludablePaths, an as InferAssetType, a6 as InferContentType, ae as InferSingleton, ad as InferSingletonContentType, K as Keyed, a7 as LocalePublicationFields, L as LocalizationConfig, X as ReadWith, W as Reading, ag as SettingsGroupConfig, ah as SettingsGroupDefinition, Y as SettingsReading, H as ShapeValue, ab as SingletonContentTypeDefinition, ac as SingletonMetadata, Z as SingletonReading, z as UnresolvedEntry, _ as UntypedReading, ax as VariantDefinition, aA as VideoCaptionsConfig, aB as VideoDownloadConfig, ap as VideoKindConfig, az as VideoPosterConfig, ay as VideoUploadConfig, aC as VideoWatermarkConfig, ak as defineAssetType, $ as defineContentType, af as defineSettingsGroup, a9 as defineSingleton, a8 as defineSingletonContentType, a0 as fieldset } from './include-paths-CrJNTsMl.js';
-export { RICH_TEXT_VOID_TAGS, RichTextAttributes, RichTextNodeContext, RichTextRenderable, RichTextReplaceableNode, RichTextTag, RichTextTarget, renderRichText, richTextToHtml, richTextToMarkdown, safeRichTextHref } from './rich-text/index.js';
-export { _ as AggregateBlock, Z as FetchBlock, aa as FilterDefinition, a7 as IncludeDefinition, ak as InferQueryParams, aj as InferQueryResponse, U as QueryConfig, W as QueryDefinition, 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, $ as SearchBlock, a9 as SelectMapping, a5 as SortCondition, a0 as WhereCondition, Q as defineQuery, d as defineSchema } from './define-schema-mrEZbY1h.js';
-export { R as RichTextBlock, a as RichTextCellAlignment, b as RichTextCodeBlock, c as RichTextCodeGroup, d as RichTextCodeLines, e as RichTextDivider, f as RichTextHeading, g as RichTextInline, h as RichTextLineBreak, i as RichTextLinkMark, j as RichTextList, k as RichTextListItem, l as RichTextListStyle, m as RichTextMark, n as RichTextMarkType, o as RichTextNode, p as RichTextParagraph, q as RichTextQuote, r as RichTextSpan, s as RichTextStructure, t as RichTextTable, u as RichTextTableCell, v as RichTextTableRow, w as RichTextValue } from './rich-text.d-rKmpgdGd.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-B97ZDj44.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-5aHmsA8j.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';
 
 /**
@@ -687,10 +685,7 @@ interface TranslationCompleteness {
  *
  * @example
  * ```typescript
- * const product = await client.content('product')
- *   .findById('prod_123')
- *   .locale('de-DE')
- *   .execute()
+ * const product = await client.content('product').get('prod_123', { locale: 'de-DE' })
  *
  * if (localeHelpers.needsTranslation(product)) {
  *   showTranslationBadge()
@@ -776,10 +771,7 @@ declare function estimateTranslationCompleteness(entry: LocalizedEntry, localize
  *
  * @example
  * ```typescript
- * const entry = await client.content('product')
- *   .findById('prod_123')
- *   .allLocales()
- *   .execute()
+ * const entry = await client.content('product').get('prod_123', { locale: '*' })
  *
  * const spanishTitle = localeHelpers.getLocalizedField(entry, 'title', 'es-ES')
  * ```
@@ -816,70 +808,41 @@ declare const localeHelpers: {
 };
 
 /**
- * The DOM↔field binding contract, as the one pure helper that emits it.
- *
- * Spread onto the element that renders a field, it stamps which entry, content type, field and
- * locale produced that element, so an editing surface can find the field by scanning the DOM
- * rather than by guessing (`INV-TB-BINDING`). The contract is `toolbar-spec.md` §DOM↔field; this
- * file is its only implementation.
- *
- * **Frozen** (`INV-SS-BINDING-FROZEN`). The attribute set is exactly the five below. Adding,
- * renaming or dropping one is a new contract, and a new contract is a bump of `data-relyio-v` — a
- * page built against version 1 keeps being read as version 1 by any surface that scans it.
- *
- * **Pure** (`INV-TB-SDK-PURE`). It reads the entry it is handed and returns attributes. It imports
- * nothing but the SDK's own types: no realtime, no AI, no first-party code, no framework. That is
- * what lets it live in the customer SDK and run on a server render as happily as in a browser.
- *
- * **Every value comes from the entry.** The id, the content type and the locale are the ones the
- * API reported in `_metadata` — the locale is the one the payload's field values were composed
- * for. There is deliberately no `locale` argument: a caller-supplied locale could bind a node to a
- * locale whose value it is not rendering, which is the silently inferred binding `INV-TB-BINDING`
- * forbids.
- */
-
-/** The version of the binding contract this helper emits. */
-declare const BINDING_VERSION = "1";
-/** The attributes `relyioField` returns — the whole of binding contract version 1. */
-interface RelyIOFieldAttributes {
-    /** The entry's id (`_metadata.id`). */
-    readonly 'data-relyio-entry': string;
-    /** The entry's content type (`_metadata.type`); every customer read is keyed by it. */
-    readonly 'data-relyio-type': string;
-    /** The field the element renders. */
-    readonly 'data-relyio-field': string;
-    /** The locale the entry's field values were composed for (`_metadata.locale`). */
-    readonly 'data-relyio-locale': string;
-    /** The binding contract's version. */
-    readonly 'data-relyio-v': typeof BINDING_VERSION;
-}
+ * A key path (REL-1814): where a value sits inside an entry, each item on the way named by its
+ * `_key` — `sections[_key=="f2k6ub9s"].heading`. A field by its id (`title`), a field of an object's
+ * value after the object's (`hero.title`), an item of a list by its key (`faq[_key=="k1"]`) and a
+ * field of that item after it (`faq[_key=="k1"].question`), to any depth. Inside a rich-text field a
+ * key names a declared Block or Inline element wherever it stands in the tree (`body[_key=="c1"]`):
+ * a key is unique within the field, nested trees included, so the path needs no step for the quote
+ * or the list item around it, and a field of the node follows it (`body[_key=="c1"].caption`).
+ *
+ * It is the spelling a validation error's path, a live binding, a comment's anchor and a filled
+ * field's path already use, so the address a page stamps is the one the Studio opens a field by,
+ * and it stays on its item when the list is reordered — which an index would not. The rule is
+ * `@relyio/schema`'s `formatItemPath` and `parseKeyedPath`, restated here because this package takes
+ * no runtime from that one (it is build-inlined for types only); `devtools/verification`'s
+ * `key-paths-sdk.test.ts` holds the two to one corpus.
+ */
+/** One step of a key path: a field by its id, or the item of the list (or rich text) before it. */
+type KeyPathSegment = {
+    readonly field: string;
+} | {
+    readonly key: string;
+};
 /**
- * The field names `relyioField` accepts for an entry of type `T`.
- *
- * A schema-typed entry narrows to its declared field names, so they autocomplete and a misspelt
- * one does not compile. An entry with no declared fields — `BaseContent`, which is what an
- * un-generated client returns — has none to narrow to, and `keyof` of it is `never`; that would
- * make the helper uncallable for every untyped customer, so it accepts any field name instead.
+ * The key path of an item of the list at `listPath` — `faq[_key=="k1"]` — or of a field inside it
+ * when `field` is given: `faq[_key=="k1"].question`. The key is written as a JSON string, so a quote
+ * in it stays inside it. `listPath` and `field` are key paths of their own (`sections[_key=="a"].links`,
+ * `link.label`).
  */
-type RelyIOFieldName<T extends BaseContent> = [Exclude<keyof T, '_metadata'>] extends [never] ? string : string & Exclude<keyof T, '_metadata'>;
+declare function formatKeyPath(listPath: string, key: string, field?: string): string;
 /**
- * Binding attributes for one field of one entry.
- *
- * @example
- * ```tsx
- * import { relyioField } from '@relyio/sdk'
- *
- * <h1 {...relyioField(post, 'title')}>{post.title}</h1>
- * // → data-relyio-entry="6710f…" data-relyio-type="post" data-relyio-field="title"
- * //   data-relyio-locale="en-US" data-relyio-v="1"
- * ```
- *
- * @throws {TypeError} when the entry's `_metadata` lacks its id, content type or locale. Every
- * entry the API returns carries all three, so this is reached only by a value that was not read
- * from RelyIO. It throws rather than emitting a partial binding: a node stamped with no locale, or
- * none at all, is a binding a surface would have to guess the rest of.
+ * A key path read back into its steps: `sections[_key=="a"].links[_key=="b"].label` → `sections`,
+ * `a`, `links`, `b`, `label`. A path with no item in it is its field ids (`hero.title` → `hero`,
+ * `title`). `null` for anything else — an index (`faq[0]`), an item of an item, an unterminated or
+ * empty key, an empty field id — which names no value by key.
  */
-declare function relyioField<T extends BaseContent>(entry: T, field: RelyIOFieldName<T>): RelyIOFieldAttributes;
+declare function parseKeyPath(path: string): KeyPathSegment[] | null;
 
 /**
  * The DOM event a preview surface dispatches when content on the page has changed, and the one
@@ -981,19 +944,18 @@ declare function snapToLadder(value: number): number;
  * ```typescript
  * import { createClient, defineSchema, defineContentType, fields } from '@relyio/sdk'
  *
- * const product = defineContentType('product', {
- *   displayName: 'Product',
- *   fields: [
- *     fields.shortText('title', { config: { required: true } }),
- *     fields.decimal('price', { config: { min: 0, decimalPlaces: 2 } }),
- *   ]
+ * const product = defineContentType({
+ *   fields: {
+ *     title: fields.shortText({ required: true }),
+ *     price: fields.decimal({ min: 0, decimalPlaces: 2 }),
+ *   },
  * })
  *
  * const schema = defineSchema({ contentTypes: { product } })
  * const client = createClient({ apiKey: '...', schema })
  *
  * // Full autocomplete for content types and fields!
- * const products = await client.content('product').query().execute()
+ * const { data: products } = await client.content('product').list({ sort: { price: 'asc' } })
  * ```
  *
  * @example Without schema (dynamic usage)
@@ -1003,11 +965,11 @@ declare function snapToLadder(value: number): number;
  * const client = createClient({ apiKey: '...' })
  *
  * // Works dynamically without type checking
- * const products = await client.content('product').query().execute()
- * const results = await client.search('wireless').in('product').execute()
+ * const { data: products } = await client.content('product').list()
+ * const results = await client.search('wireless', { contentType: 'product' })
  * ```
  */
 
 declare const VERSION = "__VERSION__";
 
-export { AuthorizationError, BaseContent, 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 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 RelyIOFieldAttributes, type RelyIOFieldName, type RelyIOResyncDetail, SDKError, ServerError, ServiceIndeterminateError, TimeoutError, TransactionRolledBackError, type TranslationCompleteness, UnknownContractError, UsageQuotaExceededError, VERSION, buildLanguageSwitcher, classifyFollowFailure, estimateTranslationCompleteness, followChanges, getAllLocalizedValues, getAvailableLocaleCodes, getDefaultLocale, getFallbackFields, getFieldFallbackLocale, getLocalizedField, getPublishedLocaleCodes, getRequestedLocale, hasLocale, isFieldFallback, isPublishableKey, isPublishedInLocale, localeHelpers, needsTranslation, relyioField, 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, 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 };

package/dist/index.js

@@ -1,10 +1,10 @@
-export { defineAssetType, defineContentType, defineQuery, defineSchema, defineSettingsGroup, defineSingleton, defineSingletonContentType, fields, fieldset } from './chunk-POEEDYFM.js';
-import { LiveEdgeError, SDKError, serviceInstructedDelayMs, VISITOR_ADMISSION_RETRY_AFTER_SECONDS, isAborted, sleep } from './chunk-FRJEUAAF.js';
-export { AdhocQueryBuilder, AdhocQueryClient, AssetClient, AssetFileBuilder, AssetUploadBuilder, AuthorizationError, AutocompleteBuilder, BaseValidationError, BatchBuilder, BatchClient, ChangesExpiredError, ConnectionError, ContentByIdBuilder, ContentClient, ContentQueryBuilder, ErrorMapper, FileUploadError, FileValidationError, HttpClient, InvalidApiKeyError, InvalidPayloadError, LIVE_KEEPALIVE_INTERVAL_MS, LIVE_SOCKET_OPEN_TIMEOUT_MS, LiveEdgeError, MethodNotAllowedError, MissingApiKeyError, NetworkError, PUBLISHABLE_KEY_PREFIX, PayloadTooLargeError, PlanFeatureUnavailableError, RateLimitError, ReadOnlyKeyError, ResourceConflictError, ResourceExpiredError, ResourceNotFoundError, SDKError, SearchBuilder, SearchClient, ServerError, ServiceIndeterminateError, SettingsClient, SimilarBuilder, SingletonClient, TimeoutError, TransactionRolledBackError, TypedRelyIOClient, UnknownContractError, UsageQuotaExceededError, ValidationError, createClient, createClient as default, entityTagOf, isAssetEntry, isPublishableKey, isResourceNotFound, matchRoute, validateFile } from './chunk-FRJEUAAF.js';
+export { defineAssetType, defineContentType, defineQuery, defineSchema, defineSettingsGroup, defineSingleton, fields, fieldset } from './chunk-PCFTJLEP.js';
+import { LiveEdgeError, SDKError, serviceInstructedDelayMs, VISITOR_ADMISSION_RETRY_AFTER_SECONDS, isAborted, sleep } from './chunk-DBBZVZOS.js';
+export { AssetClient, AssetFileBuilder, AssetUploadBuilder, AuthorizationError, BaseValidationError, ChangesExpiredError, ConnectionError, ContentClient, ErrorMapper, FileUploadError, FileValidationError, HttpClient, InvalidApiKeyError, InvalidPayloadError, LIVE_KEEPALIVE_INTERVAL_MS, LIVE_SOCKET_OPEN_TIMEOUT_MS, LiveEdgeError, MethodNotAllowedError, MissingApiKeyError, NetworkError, PUBLISHABLE_KEY_PREFIX, PayloadTooLargeError, PlanFeatureUnavailableError, RateLimitError, ReadOnlyKeyError, ResourceConflictError, ResourceExpiredError, ResourceNotFoundError, SDKError, ServerError, ServiceIndeterminateError, SettingsClient, SingletonClient, TimeoutError, TransactionRolledBackError, TypedRelyIOClient, UnknownContractError, UsageQuotaExceededError, ValidationError, createClient, createClient as default, isAssetEntry, isMissingEntry, isPublishableKey, isResourceNotFound, matchRoute, validateFile, versionCheckOf } from './chunk-DBBZVZOS.js';
 import './chunk-BBUB7C2Z.js';
 import './chunk-IY5LSKXU.js';
 export { camelToSnake, createDeferred, debounce, deepClone, generateId, isBrowser, isNode, isPlainObject, isValidEmail, isValidUrl, mergeDeep, omit, pick, retry, sleep, snakeToCamel, throttle, toSafeString } from './chunk-H6IBQSMM.js';
-export { RICH_TEXT_VOID_TAGS, renderRichText, richTextToHtml, richTextToMarkdown, safeRichTextHref } from './chunk-3DRDHXLY.js';
+export { RICH_TEXT_VOID_TAGS, entryHeadingAnchors, escapeHtml, formatKeyPath, isDeclaredRichTextNode, parseKeyPath, relyioField, renderRichText, richTextHeadingAnchors, richTextHeadingSlug, richTextToHtml, richTextToMarkdown, safeRichTextHref } from './chunk-5UMY6CS4.js';
 import { __name } from './chunk-XQ4QHWZE.js';
 
 /* RelyIO SDK - Built with ❤️ by the RelyIO Team */
@@ -253,30 +253,6 @@ var localeHelpers = {
   getAllLocalizedValues
 };
 
-// src/binding/relyio-field.ts
-var BINDING_VERSION = "1";
-function relyioField(entry, field) {
-  const metadata = entry._metadata;
-  return {
-    "data-relyio-entry": requireMetadata(metadata, "id", field),
-    "data-relyio-type": requireMetadata(metadata, "type", field),
-    "data-relyio-field": field,
-    "data-relyio-locale": requireMetadata(metadata, "locale", field),
-    "data-relyio-v": BINDING_VERSION
-  };
-}
-__name(relyioField, "relyioField");
-function requireMetadata(metadata, key, field) {
-  const value = metadata?.[key];
-  if (typeof value !== "string" || value.length === 0) {
-    throw new TypeError(
-      `relyioField(entry, '${field}'): the entry has no _metadata.${key}, so the field cannot be bound. Pass an entry as the RelyIO API returned it.`
-    );
-  }
-  return value;
-}
-__name(requireMetadata, "requireMetadata");
-
 // src/binding/change-event.ts
 var RELYIO_CHANGE_EVENT = "relyio:change";
 var RELYIO_RESYNC_EVENT = "relyio:resync";
@@ -298,6 +274,6 @@ __name(snapToLadder, "snapToLadder");
 // src/index.ts
 var VERSION = "__VERSION__";
 
-export { FOLLOW_BACK_OFF_MAX_MS, FOLLOW_RETRY_BASE_MS, FOLLOW_RETRY_MAX_MS, IMAGE_LADDER, RELYIO_CHANGE_EVENT, RELYIO_RESYNC_EVENT, VERSION, buildLanguageSwitcher, classifyFollowFailure, estimateTranslationCompleteness, followChanges, getAllLocalizedValues, getAvailableLocaleCodes, getDefaultLocale, getFallbackFields, getFieldFallbackLocale, getLocalizedField, getPublishedLocaleCodes, getRequestedLocale, hasLocale, isFieldFallback, isPublishedInLocale, localeHelpers, needsTranslation, relyioField, snapToLadder };
+export { FOLLOW_BACK_OFF_MAX_MS, FOLLOW_RETRY_BASE_MS, FOLLOW_RETRY_MAX_MS, IMAGE_LADDER, RELYIO_CHANGE_EVENT, RELYIO_RESYNC_EVENT, VERSION, buildLanguageSwitcher, classifyFollowFailure, estimateTranslationCompleteness, followChanges, getAllLocalizedValues, getAvailableLocaleCodes, getDefaultLocale, getFallbackFields, getFieldFallbackLocale, getLocalizedField, getPublishedLocaleCodes, getRequestedLocale, hasLocale, isFieldFallback, isPublishedInLocale, localeHelpers, needsTranslation, snapToLadder };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map