@relyio/sdk 0.2.1 → 0.4.0

package/dist/index.d.cts

@@ -1,9 +1,10 @@
-export { N as AdhocAggregateBlock, M as AdhocFetchBlock, L as AdhocQueryBuilder, K as AdhocQueryClient, W as AdhocQueryDefinition, X as AdhocQueryOptions, Z as AdhocQueryResult, P as AdhocSearchBlock, Q as AdhocSimilarBlock, O as AggregateMetric, _ as AssetClient, a8 as AssetEntryResponse, a5 as AssetFileBlock, $ as AssetFileBuilder, a6 as AssetFileExtracted, a0 as AssetUploadBuilder, a7 as AssetUrls, a2 as AssetVisibility, A as AutocompleteBuilder, t as AutocompleteResponse, s as AutocompleteSuggestion, y as BatchBuilder, B as BatchClient, z as BatchMethod, D as BatchOperation, G as BatchOperationResult, F as BatchOptions, J as BatchResponse, I as BatchSummary, j as ChildrenOptions, C as ClientSchema, b as ConditionalWriteOptions, ac as ConfirmInput, ad as ConfirmResult, i as ContentByIdBuilder, d as ContentClient, h as ContentQueryBuilder, ag as CreateAssetOptions, E as ExtendedQueryResult, a4 as FileBackend, am as FileErrorCode, a3 as FileStatus, an as FileUploadError, ap as FileValidationConstraints, ao as FileValidationError, U as FilterValue, V as FullTextConfig, H as HttpClient, ai as MultipartCreateResult, aj as MultipartPart, ak as MultipartTarget, a9 as PopulatedAssetReference, aa as PresignInput, ab as PresignResult, Y as QueryMetadata, ae as ResolveUrlInput, af as ResolveUrlResult, R as RetryableWriteOptions, n as SearchBuilder, m as SearchClient, x as SearchFields, w as SearchFilter, p as SearchMode, r as SearchResponse, q as SearchResultItem, S as SendOptions, g as SettingsClient, l as SettingsFetchOptions, o as SimilarBuilder, v as SimilarResponse, u as SimilarResult, f as SingletonClient, k as SingletonFetchOptions, a as TypedClientConfig, T as TypedRelyIOClient, al as UploadProgress, ah as WaitUntilReadyOptions, c as createClient, c as default, e as entityTagOf, a1 as isAssetEntry, aq as validateFile } from './index-DGWaawHt.cjs';
+export { W as AdhocAggregateBlock, V as AdhocFetchBlock, U as AdhocQueryBuilder, Q as AdhocQueryClient, a0 as AdhocQueryDefinition, a1 as AdhocQueryOptions, a3 as AdhocQueryResult, Y as AdhocSearchBlock, Z as AdhocSimilarBlock, X as AggregateMetric, a4 as AssetClient, ae as AssetEntryResponse, ab as AssetFileBlock, a5 as AssetFileBuilder, ac as AssetFileExtracted, a6 as AssetUploadBuilder, ad as AssetUrls, a8 as AssetVisibility, A as AutocompleteBuilder, z as AutocompleteResponse, y as AutocompleteSuggestion, J as BatchBuilder, I as BatchClient, K as BatchMethod, L as BatchOperation, N as BatchOperationResult, M as BatchOptions, P as BatchResponse, O as BatchSummary, h as Change, g as ChangesExpiredError, j as ChangesExpiredReason, i as ChangesOptions, p as ChildrenOptions, C as ClientSchema, d as ConditionalWriteOptions, ai as ConfirmInput, aj as ConfirmResult, o as ContentByIdBuilder, k as ContentClient, n as ContentQueryBuilder, am as CreateAssetOptions, E as ExtendedQueryResult, aa as FileBackend, aw as FileErrorCode, a9 as FileStatus, ax as FileUploadError, az as FileValidationConstraints, ay as FileValidationError, _ as FilterValue, $ as FullTextConfig, H as HttpClient, ao as MultipartCreateResult, ap as MultipartPart, aq as MultipartTarget, af as PopulatedAssetReference, ag as PresignInput, ah as PresignResult, a2 as QueryMetadata, R as Register, b as RegisteredSchema, ak as ResolveUrlInput, al as ResolveUrlResult, at as ResourceConflictError, au as ResourceExpiredError, as as ResourceNotFoundError, f as RetryableWriteOptions, t as SearchBuilder, s as SearchClient, G as SearchFields, F as SearchFilter, v as SearchMode, x as SearchResponse, w as SearchResultItem, S as SendOptions, m as SettingsClient, r as SettingsFetchOptions, u as SimilarBuilder, D as SimilarResponse, B as SimilarResult, l as SingletonClient, q as SingletonFetchOptions, a as TypedClientConfig, T as TypedRelyIOClient, ar as UploadProgress, an as WaitUntilReadyOptions, c as createClient, c as default, e as entityTagOf, a7 as isAssetEntry, av as isResourceNotFound, aA as validateFile } from './index-BvO6HDtY.cjs';
 export { fields } from './schema/index.cjs';
-import { S as SDKError } from './index-BsUqCAu8.cjs';
-export { a as ApiMethod, A as ApiPath, r as ApiResponse, b as ApiSuccessBody, B as BaseContent, v as BaseValidationError, o as CacheConfig, t as CacheStrategy, f as ContentQueryResult, j as ContentTypeSchema, C as CreateInput, i as CustomQuery, D as DebugConfig, E as Environment, k as FieldOptions, F as FieldTypeName, z as InvalidFieldTypeError, I as InvalidPayloadError, L as LogLevel, P as PerformanceMetrics, Q as QueryOptions, p as RealtimeConfig, m as RealtimeEvent, l as RealtimeEventType, R as RelyIOConfig, q as RequestConfig, y as RequiredFieldError, s as RetryConfig, x as SchemaValidationError, h as SettingsGroup, g as SingletonContent, e as SortOptions, n as SubscriptionOptions, U as UpdateInput, w as ValidationError, V as ValidationRule, u as ValidationViolation, c as WhereClause, d as WhereOperator, W as Wire } from './index-BsUqCAu8.cjs';
+import { S as SDKError, B as BaseContent } from './index-DFehx5sI.cjs';
+export { a as ApiMethod, A as ApiPath, t as ApiResponse, b as ApiSuccessBody, x as BaseValidationError, q as CacheConfig, v as CacheStrategy, g as ContentQueryResult, k as ContentTypeSchema, C as CreateInput, j as CustomQuery, D as DebugConfig, E as Environment, l as FieldOptions, F as FieldTypeName, H as InvalidFieldTypeError, I as InvalidPayloadError, L as LogLevel, M as MatchRouteOptions, P as PerformanceMetrics, Q as QueryOptions, r as RealtimeConfig, o as RealtimeEvent, n as RealtimeEventType, R as RelyIOConfig, s as RequestConfig, G as RequiredFieldError, u as RetryConfig, c as RouteMatch, z as SchemaValidationError, i as SettingsGroup, h as SingletonContent, f as SortOptions, p as SubscriptionOptions, U as UpdateInput, y as ValidationError, V as ValidationRule, w as ValidationViolation, d as WhereClause, e as WhereOperator, W as Wire, m as matchRoute } from './index-DFehx5sI.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 { bv as AggregateBlock, ap as AssetTypeConfig, as as AssetTypeDefinition, n as BaseFieldConfig, ae as ComponentConfig, af as ComponentDefinition, ag as ComponentMetadata, a1 as ContentTypeConfig, a2 as ContentTypeConfigWithFields, a3 as ContentTypeConfigWithFieldsets, a4 as ContentTypeDefinition, a5 as EntryMetadata, bu as FetchBlock, c as FieldDefinition, b as FieldRule, o as FieldType, F as FieldUIConfig, a0 as Fieldset, aw as FileKindConfig, aK as FileScanConfig, aJ as FileUploadConfig, bF as FilterDefinition, aC as ImageExifConfig, au as ImageKindConfig, aB as ImageSourceConfig, aA as ImageUploadConfig, bD as IncludeDefinition, at as InferAssetType, a6 as InferContentType, bL as InferQueryParams, bK as InferQueryResponse, ac as InferSingleton, ab as InferSingletonContentType, L as LocalizationConfig, bs as QueryConfig, bt as QueryDefinition, K as SchemaAssetTypeNames, w as SchemaConfig, y as SchemaContentTypeNames, x as SchemaDefinition, H as SchemaLocaleCodes, G as SchemaQueryNames, J as SchemaSettingsGroupNames, z as SchemaSingletonNames, bw as SearchBlock, bE as SelectMapping, ak as SettingsGroupConfig, al as SettingsGroupDefinition, bx as SimilarBlock, a9 as SingletonContentTypeDefinition, aa as SingletonMetadata, bB as SortCondition, aD as VariantDefinition, aG as VideoCaptionsConfig, aH as VideoDownloadConfig, av as VideoKindConfig, aF as VideoPosterConfig, aE as VideoUploadConfig, aI as VideoWatermarkConfig, by as WhereCondition, ao as defineAssetType, ad as defineComponent, _ as defineContentType, br as defineQuery, u as defineSchema, aj as defineSettingsGroup, a8 as defineSingleton, a7 as defineSingletonContentType, $ as fieldset, v as schemaToJSON } from './define-schema-DHvUCKwj.cjs';
+export { ax as AggregateBlock, G as AssetTypeConfig, K as AssetTypeDefinition, C as ComponentConfig, v as ComponentDefinition, w as ComponentMetadata, aw as FetchBlock, O as FileKindConfig, a3 as FileScanConfig, a2 as FileUploadConfig, aH as FilterDefinition, X as ImageExifConfig, N as ImageKindConfig, W as ImageSourceConfig, U as ImageUploadConfig, aF as IncludeDefinition, M as InferAssetType, aR as InferQueryParams, aQ as InferQueryResponse, t as InferSingleton, I as InferSingletonContentType, au as QueryConfig, av as QueryDefinition, h as SchemaAssetTypeNames, S as SchemaConfig, b as SchemaContentTypeNames, a as SchemaDefinition, f as SchemaLocaleCodes, e as SchemaQueryNames, g as SchemaSettingsGroupNames, c as SchemaSingletonNames, ay as SearchBlock, aG as SelectMapping, A as SettingsGroupConfig, B as SettingsGroupDefinition, az as SimilarBlock, r as SingletonContentTypeDefinition, s as SingletonMetadata, aD as SortCondition, Y as VariantDefinition, $ as VideoCaptionsConfig, a0 as VideoDownloadConfig, V as VideoKindConfig, _ as VideoPosterConfig, Z as VideoUploadConfig, a1 as VideoWatermarkConfig, aA as WhereCondition, F as defineAssetType, u as defineComponent, at as defineQuery, d as defineSchema, z as defineSettingsGroup, q as defineSingleton, p as defineSingletonContentType } from './define-schema-2xbHgtK-.cjs';
+export { n as BaseFieldConfig, x as ContentTypeConfig, y as ContentTypeConfigWithFields, z as ContentTypeConfigWithFieldsets, G as ContentTypeDefinition, H as EntryMetadata, c as FieldDefinition, b as FieldRule, o as FieldType, F as FieldUIConfig, w as Fieldset, J as InferContentType, K as LocalePublicationFields, L as LocalizationConfig, u as defineContentType, v as fieldset } from './define-content-type-CBfnTWSS.cjs';
 
 /**
  * Network-related errors
@@ -56,47 +57,6 @@ declare class InvalidApiKeyError extends SDKError {
     getUserMessage(): string;
 }
 
-/**
- * Content and resource errors.
- *
- * `ContentTypeNotFoundError` and `ContentNotFoundError` were deleted at API5.
- * The mapper reached them by sniffing `CONTENT_TYPE_NOT_FOUND` and
- * `CONTENT_NOT_FOUND`, neither of which is in the closed vocabulary, so neither
- * class was reachable. Both cases are `RESOURCE_NOT_FOUND`, whose declared
- * `details` are `{ kind, id? }` — the same two facts, from the one code a route
- * can actually declare.
- */
-declare class ResourceNotFoundError extends SDKError {
-    readonly code = "RESOURCE_NOT_FOUND";
-    readonly retryable = false;
-    constructor(message?: string, statusCode?: number, cause?: Error, context?: Record<string, unknown>);
-    getUserMessage(): string;
-}
-declare class ResourceConflictError extends SDKError {
-    readonly code = "RESOURCE_CONFLICT";
-    readonly retryable = false;
-    constructor(message?: string, statusCode?: number, cause?: Error, context?: Record<string, unknown>);
-    getUserMessage(): string;
-}
-declare class ResourceExpiredError extends SDKError {
-    readonly code = "RESOURCE_EXPIRED";
-    readonly retryable = false;
-    constructor(message?: string, statusCode?: number, cause?: Error, context?: Record<string, unknown>);
-    getUserMessage(): string;
-}
-/**
- * "Did the service say this resource does not exist?"
- *
- * Reads the **code**, not the status. Four contract codes are 4xx on a read and
- * only one of them means "not there"; the incumbent checked `statusCode === 404`
- * on the thrown value, and a second arm duck-typed a plain object for the same
- * number so a hand-written test double would pass. Both are the branch
- * `INV-API-CLIENT-IS-DERIVED` forbids where a code exists — and the second one
- * only existed because the tests faked the boundary (rule 20). They now stub
- * `fetch`, so the double is gone with the branch.
- */
-declare function isResourceNotFound(error: unknown): boolean;
-
 /**
  * One class per contract code that had none.
  *
@@ -152,16 +112,23 @@ declare class UsageQuotaExceededError extends SDKError {
 /**
  * `RATE_LIMIT_EXCEEDED` — too many requests in the window.
  *
- * The one refusal the SDK's own retry loop acts on. `resetAt` and `limit` are
- * optional because the IP window can fill neither honestly, which is the same
- * decision the service made about its `X-RateLimit-*` headers at API0c.
+ * `resetAt` and `limit` are optional because the IP window can fill neither
+ * honestly, which is the same decision the service made about its
+ * `X-RateLimit-*` headers at API0c.
+ *
+ * `retryAfterMs` is the third and most direct of the three, and it comes from
+ * the response **headers** rather than the refusal body — which is why it has
+ * to be threaded in rather than read off `details`. The retry policy prefers it
+ * over `resetAt` and both over its own backoff.
  */
 declare class RateLimitError extends SDKError {
     readonly code = "RATE_LIMIT_EXCEEDED";
     readonly retryable = true;
     readonly limit?: number;
     readonly resetAt?: string;
-    constructor(message?: string, limit?: number, resetAt?: string, context?: Record<string, unknown>);
+    /** `Retry-After`, in milliseconds, where the response carried a readable one. */
+    readonly retryAfterMs?: number;
+    constructor(message?: string, limit?: number, resetAt?: string, context?: Record<string, unknown>, retryAfterMs?: number);
     getUserMessage(): string;
 }
 /** `METHOD_NOT_ALLOWED` — the route exists and does not serve this verb. */
@@ -195,12 +162,23 @@ declare class TransactionRolledBackError extends SDKError {
  * `SERVICE_INDETERMINATE` — a dependency the service needed to decide was
  * unreachable, so it answered "I could not tell" rather than "no"
  * (`INV-AC-INDETERMINATE-IS-AN-OUTAGE`). Retryable: it is an outage.
+ *
+ * **Retryable is not the same as replayable.** "Could not decide" means the
+ * write may already have landed, so the retry policy sends this one again only
+ * where the request was replay-safe to begin with — an idempotent verb, or a
+ * request carrying `Idempotency-Key`.
+ *
+ * `refuse()` in `@relyio/api-contract` will not serialize this code without a
+ * `Retry-After` header, so `retryAfterMs` is populated on every one of these
+ * that reaches the SDK through a RelyIO service.
  */
 declare class ServiceIndeterminateError extends SDKError {
     readonly code = "SERVICE_INDETERMINATE";
     readonly retryable = true;
     readonly missing?: string;
-    constructor(message?: string, missing?: string, context?: Record<string, unknown>);
+    /** `Retry-After`, in milliseconds. The contract requires the header on this code. */
+    readonly retryAfterMs?: number;
+    constructor(message?: string, missing?: string, context?: Record<string, unknown>, retryAfterMs?: number);
     getUserMessage(): string;
 }
 /** `INTERNAL_ERROR` — everything a client can only log (Decision 3). */
@@ -267,10 +245,6 @@ declare class ErrorMapper {
      * Check if an error is retryable
      */
     static isRetryable(error: Error): boolean;
-    /**
-     * Extract retry delay from error
-     */
-    static getRetryDelay(_error: Error): number;
 }
 
 /**
@@ -484,6 +458,113 @@ declare const localeHelpers: {
     getAllLocalizedValues: typeof getAllLocalizedValues;
 };
 
+/**
+ * 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;
+}
+/**
+ * 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.
+ */
+type RelyIOFieldName<T extends BaseContent> = [Exclude<keyof T, '_metadata'>] extends [never] ? string : string & Exclude<keyof T, '_metadata'>;
+/**
+ * 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.
+ */
+declare function relyioField<T extends BaseContent>(entry: T, field: RelyIOFieldName<T>): RelyIOFieldAttributes;
+
+/**
+ * The DOM event a preview surface dispatches when content on the page has changed, and the one
+ * spelling of its name (`sdk-surfaces-spec.md` decision 23: the toolbar emits, the framework
+ * listens).
+ *
+ * It is the same kind of seam as the binding attributes beside it: a string both sides read from the
+ * core, so the preview toolbar needs no Next dependency and `@relyio/next`'s `<RelyIORefresh />`
+ * needs no toolbar dependency. Neither restates the name.
+ *
+ * **Dispatched on `window`.** Listeners subscribe with
+ * `window.addEventListener(RELYIO_CHANGE_EVENT, …)`; the toolbar renders inside a shadow root, and
+ * `window` is the one target both sides reach without knowing where the other is mounted.
+ *
+ * **The name is a wire contract.** A page can run a toolbar and a framework package released at
+ * different times, so renaming it silently disconnects them. The `detail` a dispatch carries is
+ * the preview toolbar's to declare (SS4); a listener that only refreshes reads none of it.
+ */
+declare const RELYIO_CHANGE_EVENT = "relyio:change";
+
+/**
+ * The width ladder the delivery Worker snaps every rendered dimension to
+ * (`INV-SS-ONE-LADDER`, sdk-surfaces-spec decision 14).
+ *
+ * A dimension is clamped to a ceiling and snapped to a bucket, so "any width"
+ * cannot become "unboundedly many distinct transforms". A client that asks the
+ * Worker for `w=749` is served the `w=700` render anyway; snapping on this side
+ * first means an image loader emits the URL the edge cache already holds.
+ *
+ * This is a **copy**, and deliberately so: the core cannot import
+ * `@relyio/storage` or the Worker. `apps/edge/cdn/src/__tests__/ladder-parity.test.ts`
+ * holds the two equal — the constants, and what the Worker actually renders for
+ * a sweep of requested widths — so a divergence fails the gate rather than a
+ * cache.
+ */
+declare const IMAGE_LADDER: {
+    readonly maxDimension: 5000;
+    readonly bucket: 100;
+};
+/** Clamp to the ceiling, then snap to the nearest bucket — never below one bucket. */
+declare function snapToLadder(value: number): number;
+
 /**
  * RelyIO SDK - Main Entry Point
  *
@@ -520,4 +601,4 @@ declare const localeHelpers: {
 
 declare const VERSION = "__VERSION__";
 
-export { AuthenticationError, AuthorizationError, ConnectionError, ErrorMapper, InvalidApiKeyError, type LanguageSwitcherOption, type LanguageSwitcherOptions, type LocaleMetadata, type LocaleStatus, type LocalizedEntry, MethodNotAllowedError, MissingApiKeyError, NetworkError, PayloadTooLargeError, PlanFeatureUnavailableError, RateLimitError, ReadOnlyKeyError, ResourceConflictError, ResourceExpiredError, ResourceNotFoundError, SDKError, ServerError, ServiceIndeterminateError, TimeoutError, TransactionRolledBackError, type TranslationCompleteness, UnknownContractError, UsageQuotaExceededError, VERSION, buildLanguageSwitcher, estimateTranslationCompleteness, getAllLocalizedValues, getAvailableLocaleCodes, getDefaultLocale, getFallbackFields, getFieldFallbackLocale, getLocalizedField, getPublishedLocaleCodes, getRequestedLocale, hasLocale, isFieldFallback, isPublishedInLocale, isResourceNotFound, localeHelpers, needsTranslation };
+export { AuthenticationError, AuthorizationError, BaseContent, ConnectionError, ErrorMapper, IMAGE_LADDER, InvalidApiKeyError, type LanguageSwitcherOption, type LanguageSwitcherOptions, type LocaleMetadata, type LocaleStatus, type LocalizedEntry, MethodNotAllowedError, MissingApiKeyError, NetworkError, PayloadTooLargeError, PlanFeatureUnavailableError, RELYIO_CHANGE_EVENT, RateLimitError, ReadOnlyKeyError, type RelyIOFieldAttributes, type RelyIOFieldName, SDKError, ServerError, ServiceIndeterminateError, TimeoutError, TransactionRolledBackError, type TranslationCompleteness, UnknownContractError, UsageQuotaExceededError, VERSION, buildLanguageSwitcher, estimateTranslationCompleteness, getAllLocalizedValues, getAvailableLocaleCodes, getDefaultLocale, getFallbackFields, getFieldFallbackLocale, getLocalizedField, getPublishedLocaleCodes, getRequestedLocale, hasLocale, isFieldFallback, isPublishedInLocale, localeHelpers, needsTranslation, relyioField, snapToLadder };

package/dist/index.d.ts

@@ -1,9 +1,10 @@
-export { N as AdhocAggregateBlock, M as AdhocFetchBlock, L as AdhocQueryBuilder, K as AdhocQueryClient, W as AdhocQueryDefinition, X as AdhocQueryOptions, Z as AdhocQueryResult, P as AdhocSearchBlock, Q as AdhocSimilarBlock, O as AggregateMetric, _ as AssetClient, a8 as AssetEntryResponse, a5 as AssetFileBlock, $ as AssetFileBuilder, a6 as AssetFileExtracted, a0 as AssetUploadBuilder, a7 as AssetUrls, a2 as AssetVisibility, A as AutocompleteBuilder, t as AutocompleteResponse, s as AutocompleteSuggestion, y as BatchBuilder, B as BatchClient, z as BatchMethod, D as BatchOperation, G as BatchOperationResult, F as BatchOptions, J as BatchResponse, I as BatchSummary, j as ChildrenOptions, C as ClientSchema, b as ConditionalWriteOptions, ac as ConfirmInput, ad as ConfirmResult, i as ContentByIdBuilder, d as ContentClient, h as ContentQueryBuilder, ag as CreateAssetOptions, E as ExtendedQueryResult, a4 as FileBackend, am as FileErrorCode, a3 as FileStatus, an as FileUploadError, ap as FileValidationConstraints, ao as FileValidationError, U as FilterValue, V as FullTextConfig, H as HttpClient, ai as MultipartCreateResult, aj as MultipartPart, ak as MultipartTarget, a9 as PopulatedAssetReference, aa as PresignInput, ab as PresignResult, Y as QueryMetadata, ae as ResolveUrlInput, af as ResolveUrlResult, R as RetryableWriteOptions, n as SearchBuilder, m as SearchClient, x as SearchFields, w as SearchFilter, p as SearchMode, r as SearchResponse, q as SearchResultItem, S as SendOptions, g as SettingsClient, l as SettingsFetchOptions, o as SimilarBuilder, v as SimilarResponse, u as SimilarResult, f as SingletonClient, k as SingletonFetchOptions, a as TypedClientConfig, T as TypedRelyIOClient, al as UploadProgress, ah as WaitUntilReadyOptions, c as createClient, c as default, e as entityTagOf, a1 as isAssetEntry, aq as validateFile } from './index-B-KiFHbx.js';
+export { W as AdhocAggregateBlock, V as AdhocFetchBlock, U as AdhocQueryBuilder, Q as AdhocQueryClient, a0 as AdhocQueryDefinition, a1 as AdhocQueryOptions, a3 as AdhocQueryResult, Y as AdhocSearchBlock, Z as AdhocSimilarBlock, X as AggregateMetric, a4 as AssetClient, ae as AssetEntryResponse, ab as AssetFileBlock, a5 as AssetFileBuilder, ac as AssetFileExtracted, a6 as AssetUploadBuilder, ad as AssetUrls, a8 as AssetVisibility, A as AutocompleteBuilder, z as AutocompleteResponse, y as AutocompleteSuggestion, J as BatchBuilder, I as BatchClient, K as BatchMethod, L as BatchOperation, N as BatchOperationResult, M as BatchOptions, P as BatchResponse, O as BatchSummary, h as Change, g as ChangesExpiredError, j as ChangesExpiredReason, i as ChangesOptions, p as ChildrenOptions, C as ClientSchema, d as ConditionalWriteOptions, ai as ConfirmInput, aj as ConfirmResult, o as ContentByIdBuilder, k as ContentClient, n as ContentQueryBuilder, am as CreateAssetOptions, E as ExtendedQueryResult, aa as FileBackend, aw as FileErrorCode, a9 as FileStatus, ax as FileUploadError, az as FileValidationConstraints, ay as FileValidationError, _ as FilterValue, $ as FullTextConfig, H as HttpClient, ao as MultipartCreateResult, ap as MultipartPart, aq as MultipartTarget, af as PopulatedAssetReference, ag as PresignInput, ah as PresignResult, a2 as QueryMetadata, R as Register, b as RegisteredSchema, ak as ResolveUrlInput, al as ResolveUrlResult, at as ResourceConflictError, au as ResourceExpiredError, as as ResourceNotFoundError, f as RetryableWriteOptions, t as SearchBuilder, s as SearchClient, G as SearchFields, F as SearchFilter, v as SearchMode, x as SearchResponse, w as SearchResultItem, S as SendOptions, m as SettingsClient, r as SettingsFetchOptions, u as SimilarBuilder, D as SimilarResponse, B as SimilarResult, l as SingletonClient, q as SingletonFetchOptions, a as TypedClientConfig, T as TypedRelyIOClient, ar as UploadProgress, an as WaitUntilReadyOptions, c as createClient, c as default, e as entityTagOf, a7 as isAssetEntry, av as isResourceNotFound, aA as validateFile } from './index-BzOFJJKS.js';
 export { fields } from './schema/index.js';
-import { S as SDKError } from './index-BsUqCAu8.js';
-export { a as ApiMethod, A as ApiPath, r as ApiResponse, b as ApiSuccessBody, B as BaseContent, v as BaseValidationError, o as CacheConfig, t as CacheStrategy, f as ContentQueryResult, j as ContentTypeSchema, C as CreateInput, i as CustomQuery, D as DebugConfig, E as Environment, k as FieldOptions, F as FieldTypeName, z as InvalidFieldTypeError, I as InvalidPayloadError, L as LogLevel, P as PerformanceMetrics, Q as QueryOptions, p as RealtimeConfig, m as RealtimeEvent, l as RealtimeEventType, R as RelyIOConfig, q as RequestConfig, y as RequiredFieldError, s as RetryConfig, x as SchemaValidationError, h as SettingsGroup, g as SingletonContent, e as SortOptions, n as SubscriptionOptions, U as UpdateInput, w as ValidationError, V as ValidationRule, u as ValidationViolation, c as WhereClause, d as WhereOperator, W as Wire } from './index-BsUqCAu8.js';
+import { S as SDKError, B as BaseContent } from './index-FDak5ofk.js';
+export { a as ApiMethod, A as ApiPath, t as ApiResponse, b as ApiSuccessBody, x as BaseValidationError, q as CacheConfig, v as CacheStrategy, g as ContentQueryResult, k as ContentTypeSchema, C as CreateInput, j as CustomQuery, D as DebugConfig, E as Environment, l as FieldOptions, F as FieldTypeName, H as InvalidFieldTypeError, I as InvalidPayloadError, L as LogLevel, M as MatchRouteOptions, P as PerformanceMetrics, Q as QueryOptions, r as RealtimeConfig, o as RealtimeEvent, n as RealtimeEventType, R as RelyIOConfig, s as RequestConfig, G as RequiredFieldError, u as RetryConfig, c as RouteMatch, z as SchemaValidationError, i as SettingsGroup, h as SingletonContent, f as SortOptions, p as SubscriptionOptions, U as UpdateInput, y as ValidationError, V as ValidationRule, w as ValidationViolation, d as WhereClause, e as WhereOperator, W as Wire, m as matchRoute } from './index-FDak5ofk.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 { bv as AggregateBlock, ap as AssetTypeConfig, as as AssetTypeDefinition, n as BaseFieldConfig, ae as ComponentConfig, af as ComponentDefinition, ag as ComponentMetadata, a1 as ContentTypeConfig, a2 as ContentTypeConfigWithFields, a3 as ContentTypeConfigWithFieldsets, a4 as ContentTypeDefinition, a5 as EntryMetadata, bu as FetchBlock, c as FieldDefinition, b as FieldRule, o as FieldType, F as FieldUIConfig, a0 as Fieldset, aw as FileKindConfig, aK as FileScanConfig, aJ as FileUploadConfig, bF as FilterDefinition, aC as ImageExifConfig, au as ImageKindConfig, aB as ImageSourceConfig, aA as ImageUploadConfig, bD as IncludeDefinition, at as InferAssetType, a6 as InferContentType, bL as InferQueryParams, bK as InferQueryResponse, ac as InferSingleton, ab as InferSingletonContentType, L as LocalizationConfig, bs as QueryConfig, bt as QueryDefinition, K as SchemaAssetTypeNames, w as SchemaConfig, y as SchemaContentTypeNames, x as SchemaDefinition, H as SchemaLocaleCodes, G as SchemaQueryNames, J as SchemaSettingsGroupNames, z as SchemaSingletonNames, bw as SearchBlock, bE as SelectMapping, ak as SettingsGroupConfig, al as SettingsGroupDefinition, bx as SimilarBlock, a9 as SingletonContentTypeDefinition, aa as SingletonMetadata, bB as SortCondition, aD as VariantDefinition, aG as VideoCaptionsConfig, aH as VideoDownloadConfig, av as VideoKindConfig, aF as VideoPosterConfig, aE as VideoUploadConfig, aI as VideoWatermarkConfig, by as WhereCondition, ao as defineAssetType, ad as defineComponent, _ as defineContentType, br as defineQuery, u as defineSchema, aj as defineSettingsGroup, a8 as defineSingleton, a7 as defineSingletonContentType, $ as fieldset, v as schemaToJSON } from './define-schema-DHvUCKwj.js';
+export { ax as AggregateBlock, G as AssetTypeConfig, K as AssetTypeDefinition, C as ComponentConfig, v as ComponentDefinition, w as ComponentMetadata, aw as FetchBlock, O as FileKindConfig, a3 as FileScanConfig, a2 as FileUploadConfig, aH as FilterDefinition, X as ImageExifConfig, N as ImageKindConfig, W as ImageSourceConfig, U as ImageUploadConfig, aF as IncludeDefinition, M as InferAssetType, aR as InferQueryParams, aQ as InferQueryResponse, t as InferSingleton, I as InferSingletonContentType, au as QueryConfig, av as QueryDefinition, h as SchemaAssetTypeNames, S as SchemaConfig, b as SchemaContentTypeNames, a as SchemaDefinition, f as SchemaLocaleCodes, e as SchemaQueryNames, g as SchemaSettingsGroupNames, c as SchemaSingletonNames, ay as SearchBlock, aG as SelectMapping, A as SettingsGroupConfig, B as SettingsGroupDefinition, az as SimilarBlock, r as SingletonContentTypeDefinition, s as SingletonMetadata, aD as SortCondition, Y as VariantDefinition, $ as VideoCaptionsConfig, a0 as VideoDownloadConfig, V as VideoKindConfig, _ as VideoPosterConfig, Z as VideoUploadConfig, a1 as VideoWatermarkConfig, aA as WhereCondition, F as defineAssetType, u as defineComponent, at as defineQuery, d as defineSchema, z as defineSettingsGroup, q as defineSingleton, p as defineSingletonContentType } from './define-schema-DzYXk4HL.js';
+export { n as BaseFieldConfig, x as ContentTypeConfig, y as ContentTypeConfigWithFields, z as ContentTypeConfigWithFieldsets, G as ContentTypeDefinition, H as EntryMetadata, c as FieldDefinition, b as FieldRule, o as FieldType, F as FieldUIConfig, w as Fieldset, J as InferContentType, K as LocalePublicationFields, L as LocalizationConfig, u as defineContentType, v as fieldset } from './define-content-type-CBfnTWSS.js';
 
 /**
  * Network-related errors
@@ -56,47 +57,6 @@ declare class InvalidApiKeyError extends SDKError {
     getUserMessage(): string;
 }
 
-/**
- * Content and resource errors.
- *
- * `ContentTypeNotFoundError` and `ContentNotFoundError` were deleted at API5.
- * The mapper reached them by sniffing `CONTENT_TYPE_NOT_FOUND` and
- * `CONTENT_NOT_FOUND`, neither of which is in the closed vocabulary, so neither
- * class was reachable. Both cases are `RESOURCE_NOT_FOUND`, whose declared
- * `details` are `{ kind, id? }` — the same two facts, from the one code a route
- * can actually declare.
- */
-declare class ResourceNotFoundError extends SDKError {
-    readonly code = "RESOURCE_NOT_FOUND";
-    readonly retryable = false;
-    constructor(message?: string, statusCode?: number, cause?: Error, context?: Record<string, unknown>);
-    getUserMessage(): string;
-}
-declare class ResourceConflictError extends SDKError {
-    readonly code = "RESOURCE_CONFLICT";
-    readonly retryable = false;
-    constructor(message?: string, statusCode?: number, cause?: Error, context?: Record<string, unknown>);
-    getUserMessage(): string;
-}
-declare class ResourceExpiredError extends SDKError {
-    readonly code = "RESOURCE_EXPIRED";
-    readonly retryable = false;
-    constructor(message?: string, statusCode?: number, cause?: Error, context?: Record<string, unknown>);
-    getUserMessage(): string;
-}
-/**
- * "Did the service say this resource does not exist?"
- *
- * Reads the **code**, not the status. Four contract codes are 4xx on a read and
- * only one of them means "not there"; the incumbent checked `statusCode === 404`
- * on the thrown value, and a second arm duck-typed a plain object for the same
- * number so a hand-written test double would pass. Both are the branch
- * `INV-API-CLIENT-IS-DERIVED` forbids where a code exists — and the second one
- * only existed because the tests faked the boundary (rule 20). They now stub
- * `fetch`, so the double is gone with the branch.
- */
-declare function isResourceNotFound(error: unknown): boolean;
-
 /**
  * One class per contract code that had none.
  *
@@ -152,16 +112,23 @@ declare class UsageQuotaExceededError extends SDKError {
 /**
  * `RATE_LIMIT_EXCEEDED` — too many requests in the window.
  *
- * The one refusal the SDK's own retry loop acts on. `resetAt` and `limit` are
- * optional because the IP window can fill neither honestly, which is the same
- * decision the service made about its `X-RateLimit-*` headers at API0c.
+ * `resetAt` and `limit` are optional because the IP window can fill neither
+ * honestly, which is the same decision the service made about its
+ * `X-RateLimit-*` headers at API0c.
+ *
+ * `retryAfterMs` is the third and most direct of the three, and it comes from
+ * the response **headers** rather than the refusal body — which is why it has
+ * to be threaded in rather than read off `details`. The retry policy prefers it
+ * over `resetAt` and both over its own backoff.
  */
 declare class RateLimitError extends SDKError {
     readonly code = "RATE_LIMIT_EXCEEDED";
     readonly retryable = true;
     readonly limit?: number;
     readonly resetAt?: string;
-    constructor(message?: string, limit?: number, resetAt?: string, context?: Record<string, unknown>);
+    /** `Retry-After`, in milliseconds, where the response carried a readable one. */
+    readonly retryAfterMs?: number;
+    constructor(message?: string, limit?: number, resetAt?: string, context?: Record<string, unknown>, retryAfterMs?: number);
     getUserMessage(): string;
 }
 /** `METHOD_NOT_ALLOWED` — the route exists and does not serve this verb. */
@@ -195,12 +162,23 @@ declare class TransactionRolledBackError extends SDKError {
  * `SERVICE_INDETERMINATE` — a dependency the service needed to decide was
  * unreachable, so it answered "I could not tell" rather than "no"
  * (`INV-AC-INDETERMINATE-IS-AN-OUTAGE`). Retryable: it is an outage.
+ *
+ * **Retryable is not the same as replayable.** "Could not decide" means the
+ * write may already have landed, so the retry policy sends this one again only
+ * where the request was replay-safe to begin with — an idempotent verb, or a
+ * request carrying `Idempotency-Key`.
+ *
+ * `refuse()` in `@relyio/api-contract` will not serialize this code without a
+ * `Retry-After` header, so `retryAfterMs` is populated on every one of these
+ * that reaches the SDK through a RelyIO service.
  */
 declare class ServiceIndeterminateError extends SDKError {
     readonly code = "SERVICE_INDETERMINATE";
     readonly retryable = true;
     readonly missing?: string;
-    constructor(message?: string, missing?: string, context?: Record<string, unknown>);
+    /** `Retry-After`, in milliseconds. The contract requires the header on this code. */
+    readonly retryAfterMs?: number;
+    constructor(message?: string, missing?: string, context?: Record<string, unknown>, retryAfterMs?: number);
     getUserMessage(): string;
 }
 /** `INTERNAL_ERROR` — everything a client can only log (Decision 3). */
@@ -267,10 +245,6 @@ declare class ErrorMapper {
      * Check if an error is retryable
      */
     static isRetryable(error: Error): boolean;
-    /**
-     * Extract retry delay from error
-     */
-    static getRetryDelay(_error: Error): number;
 }
 
 /**
@@ -484,6 +458,113 @@ declare const localeHelpers: {
     getAllLocalizedValues: typeof getAllLocalizedValues;
 };
 
+/**
+ * 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;
+}
+/**
+ * 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.
+ */
+type RelyIOFieldName<T extends BaseContent> = [Exclude<keyof T, '_metadata'>] extends [never] ? string : string & Exclude<keyof T, '_metadata'>;
+/**
+ * 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.
+ */
+declare function relyioField<T extends BaseContent>(entry: T, field: RelyIOFieldName<T>): RelyIOFieldAttributes;
+
+/**
+ * The DOM event a preview surface dispatches when content on the page has changed, and the one
+ * spelling of its name (`sdk-surfaces-spec.md` decision 23: the toolbar emits, the framework
+ * listens).
+ *
+ * It is the same kind of seam as the binding attributes beside it: a string both sides read from the
+ * core, so the preview toolbar needs no Next dependency and `@relyio/next`'s `<RelyIORefresh />`
+ * needs no toolbar dependency. Neither restates the name.
+ *
+ * **Dispatched on `window`.** Listeners subscribe with
+ * `window.addEventListener(RELYIO_CHANGE_EVENT, …)`; the toolbar renders inside a shadow root, and
+ * `window` is the one target both sides reach without knowing where the other is mounted.
+ *
+ * **The name is a wire contract.** A page can run a toolbar and a framework package released at
+ * different times, so renaming it silently disconnects them. The `detail` a dispatch carries is
+ * the preview toolbar's to declare (SS4); a listener that only refreshes reads none of it.
+ */
+declare const RELYIO_CHANGE_EVENT = "relyio:change";
+
+/**
+ * The width ladder the delivery Worker snaps every rendered dimension to
+ * (`INV-SS-ONE-LADDER`, sdk-surfaces-spec decision 14).
+ *
+ * A dimension is clamped to a ceiling and snapped to a bucket, so "any width"
+ * cannot become "unboundedly many distinct transforms". A client that asks the
+ * Worker for `w=749` is served the `w=700` render anyway; snapping on this side
+ * first means an image loader emits the URL the edge cache already holds.
+ *
+ * This is a **copy**, and deliberately so: the core cannot import
+ * `@relyio/storage` or the Worker. `apps/edge/cdn/src/__tests__/ladder-parity.test.ts`
+ * holds the two equal — the constants, and what the Worker actually renders for
+ * a sweep of requested widths — so a divergence fails the gate rather than a
+ * cache.
+ */
+declare const IMAGE_LADDER: {
+    readonly maxDimension: 5000;
+    readonly bucket: 100;
+};
+/** Clamp to the ceiling, then snap to the nearest bucket — never below one bucket. */
+declare function snapToLadder(value: number): number;
+
 /**
  * RelyIO SDK - Main Entry Point
  *
@@ -520,4 +601,4 @@ declare const localeHelpers: {
 
 declare const VERSION = "__VERSION__";
 
-export { AuthenticationError, AuthorizationError, ConnectionError, ErrorMapper, InvalidApiKeyError, type LanguageSwitcherOption, type LanguageSwitcherOptions, type LocaleMetadata, type LocaleStatus, type LocalizedEntry, MethodNotAllowedError, MissingApiKeyError, NetworkError, PayloadTooLargeError, PlanFeatureUnavailableError, RateLimitError, ReadOnlyKeyError, ResourceConflictError, ResourceExpiredError, ResourceNotFoundError, SDKError, ServerError, ServiceIndeterminateError, TimeoutError, TransactionRolledBackError, type TranslationCompleteness, UnknownContractError, UsageQuotaExceededError, VERSION, buildLanguageSwitcher, estimateTranslationCompleteness, getAllLocalizedValues, getAvailableLocaleCodes, getDefaultLocale, getFallbackFields, getFieldFallbackLocale, getLocalizedField, getPublishedLocaleCodes, getRequestedLocale, hasLocale, isFieldFallback, isPublishedInLocale, isResourceNotFound, localeHelpers, needsTranslation };
+export { AuthenticationError, AuthorizationError, BaseContent, ConnectionError, ErrorMapper, IMAGE_LADDER, InvalidApiKeyError, type LanguageSwitcherOption, type LanguageSwitcherOptions, type LocaleMetadata, type LocaleStatus, type LocalizedEntry, MethodNotAllowedError, MissingApiKeyError, NetworkError, PayloadTooLargeError, PlanFeatureUnavailableError, RELYIO_CHANGE_EVENT, RateLimitError, ReadOnlyKeyError, type RelyIOFieldAttributes, type RelyIOFieldName, SDKError, ServerError, ServiceIndeterminateError, TimeoutError, TransactionRolledBackError, type TranslationCompleteness, UnknownContractError, UsageQuotaExceededError, VERSION, buildLanguageSwitcher, estimateTranslationCompleteness, getAllLocalizedValues, getAvailableLocaleCodes, getDefaultLocale, getFallbackFields, getFieldFallbackLocale, getLocalizedField, getPublishedLocaleCodes, getRequestedLocale, hasLocale, isFieldFallback, isPublishedInLocale, localeHelpers, needsTranslation, relyioField, snapToLadder };

package/dist/index.js

@@ -1,5 +1,6 @@
-export { defineAssetType, defineComponent, defineContentType, defineQuery, defineSchema, defineSettingsGroup, defineSingleton, defineSingletonContentType, fields, fieldset, schemaToJSON } from './chunk-2QUK2ZGD.js';
-export { AdhocQueryBuilder, AdhocQueryClient, AssetClient, AssetFileBuilder, AssetUploadBuilder, AuthenticationError, AuthorizationError, AutocompleteBuilder, BaseValidationError, BatchBuilder, BatchClient, ConnectionError, ContentByIdBuilder, ContentClient, ContentQueryBuilder, ErrorMapper, FileUploadError, FileValidationError, HttpClient, InvalidApiKeyError, InvalidFieldTypeError, InvalidPayloadError, MethodNotAllowedError, MissingApiKeyError, NetworkError, PayloadTooLargeError, PlanFeatureUnavailableError, RateLimitError, ReadOnlyKeyError, RequiredFieldError, ResourceConflictError, ResourceExpiredError, ResourceNotFoundError, SDKError, SchemaValidationError, SearchBuilder, SearchClient, ServerError, ServiceIndeterminateError, SettingsClient, SimilarBuilder, SingletonClient, TimeoutError, TransactionRolledBackError, TypedRelyIOClient, UnknownContractError, UsageQuotaExceededError, ValidationError, createClient, createClient as default, entityTagOf, isAssetEntry, isResourceNotFound, validateFile } from './chunk-RJBIJ2ZK.js';
+export { defineAssetType, defineComponent, defineContentType, defineQuery, defineSchema, defineSettingsGroup, defineSingleton, defineSingletonContentType, fields, fieldset } from './chunk-XY5KFEFY.js';
+export { AdhocQueryBuilder, AdhocQueryClient, AssetClient, AssetFileBuilder, AssetUploadBuilder, AuthenticationError, AuthorizationError, AutocompleteBuilder, BaseValidationError, BatchBuilder, BatchClient, ChangesExpiredError, ConnectionError, ContentByIdBuilder, ContentClient, ContentQueryBuilder, ErrorMapper, FileUploadError, FileValidationError, HttpClient, InvalidApiKeyError, InvalidFieldTypeError, InvalidPayloadError, MethodNotAllowedError, MissingApiKeyError, NetworkError, PayloadTooLargeError, PlanFeatureUnavailableError, RateLimitError, ReadOnlyKeyError, RequiredFieldError, ResourceConflictError, ResourceExpiredError, ResourceNotFoundError, SDKError, SchemaValidationError, SearchBuilder, SearchClient, ServerError, ServiceIndeterminateError, SettingsClient, SimilarBuilder, SingletonClient, TimeoutError, TransactionRolledBackError, TypedRelyIOClient, UnknownContractError, UsageQuotaExceededError, ValidationError, createClient, createClient as default, entityTagOf, isAssetEntry, isResourceNotFound, matchRoute, validateFile } from './chunk-43VPZT2G.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-I3ESNANB.js';
 import { __name } from './chunk-XQ4QHWZE.js';
@@ -140,9 +141,50 @@ 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";
+
+// src/image/ladder.ts
+var IMAGE_LADDER = {
+  maxDimension: 5e3,
+  bucket: 100
+};
+function snapToLadder(value) {
+  const clamped = Math.min(Math.max(value, 1), IMAGE_LADDER.maxDimension);
+  return Math.max(
+    IMAGE_LADDER.bucket,
+    Math.round(clamped / IMAGE_LADDER.bucket) * IMAGE_LADDER.bucket
+  );
+}
+__name(snapToLadder, "snapToLadder");
+
 // src/index.ts
 var VERSION = "__VERSION__";
 
-export { VERSION, buildLanguageSwitcher, estimateTranslationCompleteness, getAllLocalizedValues, getAvailableLocaleCodes, getDefaultLocale, getFallbackFields, getFieldFallbackLocale, getLocalizedField, getPublishedLocaleCodes, getRequestedLocale, hasLocale, isFieldFallback, isPublishedInLocale, localeHelpers, needsTranslation };
+export { IMAGE_LADDER, RELYIO_CHANGE_EVENT, VERSION, buildLanguageSwitcher, estimateTranslationCompleteness, getAllLocalizedValues, getAvailableLocaleCodes, getDefaultLocale, getFallbackFields, getFieldFallbackLocale, getLocalizedField, getPublishedLocaleCodes, getRequestedLocale, hasLocale, isFieldFallback, isPublishedInLocale, localeHelpers, needsTranslation, relyioField, snapToLadder };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map