@relyio/sdk 0.15.0 → 0.16.0

package/dist/{define-content-type-Ds5rCAYl.d.ts → define-content-type-CAWSlgn0.d.ts}

@@ -439,6 +439,23 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    '/v1/{contentType}/{id}/shared-versions/{versionNumber}/restore': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Restore the untranslated fields from a version */
+        post: operations['restoreSharedEntryVersion'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/v1/{contentType}/{id}/versions': {
         parameters: {
             query?: never;
@@ -1010,7 +1027,7 @@ interface components {
                 retriable?: boolean;
             };
         };
-        /** @description An asset entry’s `urls`, sent beside its `file` once `file.status` is `ready`: an image’s `original` and `variants`, a file’s `original`, a video’s `playback`, `poster` and `download`. Every URL is on the delivery gateway; a protected or private asset’s carries a short-lived token minted for this request. */
+        /** @description An asset entry’s `urls`, sent beside its `file` once `file.status` is `ready`: an image’s `original` and `variants`, a file’s `original`, a video’s `playback`, `poster`, `download`, `captions`, `storyboard` and `storyboardSprite`. Every URL is on the delivery gateway; a protected or private asset’s carries a short-lived token minted for this request. */
         AssetUrls: {
             /** @description An image or a file: its original bytes. */
             original?: string;
@@ -1024,6 +1041,14 @@ interface components {
             poster?: string;
             /** @description A video: its downloadable MP4, when enabled. */
             download?: string;
+            /** @description A video: each caption locale its type declares (`video.captions.requiredLocales`), mapped to that WebVTT track’s URL. */
+            captions?: {
+                [key: string]: string;
+            };
+            /** @description A video: its storyboard — the WebVTT thumbnail track for scrubbing previews — once enrichment found it available. */
+            storyboard?: string;
+            /** @description A video: the sprite sheet its storyboard’s cues address, beside `storyboard`. */
+            storyboardSprite?: string;
         };
         /** @description One distinct value of the field, and the entry it was first found in. */
         AutocompleteSuggestion: {
@@ -1068,9 +1093,60 @@ interface components {
             /** @description Locale of the binding to delete */
             locale?: string;
         };
-        /** @description One entry: its fields at the top level, as the content type declares them, and `_metadata`. An asset entry also carries `file`, an `AssetFile`, and `urls`, an `AssetUrls`, once the file is ready. */
+        /** @description One version of a singleton or a settings group: the fields that locale stored when the version was written, and which version of which locale it is. */
+        DocumentVersion: {
+            /** @description The version’s own number, on `locale`’s counter. */
+            version: number;
+            /** @description That locale’s own fields, as stored when the version was written. */
+            fields: {
+                [key: string]: unknown;
+            };
+            /** @description The locale the version belongs to. */
+            locale: string;
+            /**
+             * Format: date-time
+             * @description When the version was published.
+             */
+            publishedAt: string;
+            /** @description Who wrote the version. */
+            publishedBy: string;
+        };
+        /** @description A singleton’s or a settings group’s version history in one locale, newest first, and the version it is at now. */
+        DocumentVersionHistory: {
+            /** @description The listed locale’s own version counter, the number its `_metadata.version` reports when the document is read in that locale. A locale with nothing written of its own, or one the key cannot read, reports 0 and lists no versions. */
+            currentVersion: number;
+            /** @description The locale’s versions, newest first. */
+            versions: components['schemas']['DocumentVersionRow'][];
+        };
+        /** @description One row of a singleton’s or a settings group’s version history: which version of which locale it is, who wrote it and when. The fields it stored are not listed; read one version for them. */
+        DocumentVersionRow: {
+            /** @description The version’s own number, on `locale`’s counter. */
+            version: number;
+            /** @description The locale the version belongs to. */
+            locale: string;
+            /**
+             * Format: date-time
+             * @description When the version was published.
+             */
+            publishedAt: string;
+            /** @description Who wrote the version. */
+            publishedBy: string;
+        };
+        /** @description The entry, or a locale the write reaches, has unpublished changes made in the Studio, and a write through this API would land on top of them. Publish or discard the draft, then retry. */
+        DraftExistsBlockage: {
+            /** @enum {string} */
+            kind: 'draft-exists';
+            facts: Record<string, never>;
+        };
+        /** @description One entry: its fields at the top level, as the content type declares them, and `_metadata`. An asset entry also carries `file`, an `AssetFile`, and `urls`, an `AssetUrls`, once the file is ready. A read that asks for `children` also carries `_children`. */
         Entry: {
             _metadata: components['schemas']['EntryMetadata'];
+            /** @description The entry’s first children, of every content type, to the depth the read asked for in `children`: `data` holds at most `page.limit` of them (`childrenLimit`), always from `page.offset` 0, and `page.total` counts the entry’s children, so more remain when the length of `data` is less than `page.total`. This block does not page: `GET /{contentType}/{id}/children` lists every child from its own first page, by its own cursor. For a key limited to some locales `page.total` is an upper bound, since it still counts children past `page.limit` that hold none of the key’s locales. Present only on a read that asked. */
+            _children?: {
+                /** @description The children, in the hierarchy’s order. */
+                data: components['schemas']['Entry'][];
+                page: components['schemas']['OffsetPage'];
+            };
         } & {
             [key: string]: unknown;
         };
@@ -1134,7 +1210,7 @@ interface components {
             emptyRequiredFields?: string[];
             /** @description Every locale the entry has content in, the default first. */
             availableLocales: components['schemas']['EntryLocale'][];
-            /** @description The fields of every other locale asked for, keyed by locale — on `?locales=a,b` and `?locale=*`. A locale with no visible fields is left out. */
+            /** @description The fields of every other locale asked for, keyed by locale. Present on every `?locale=*` or `?locales=` read — `{}` when no other locale has visible fields — and absent on a single-locale read. A locale with no visible fields is left out. */
             localizations?: {
                 [key: string]: {
                     [key: string]: unknown;
@@ -1170,9 +1246,110 @@ interface components {
             /** @description The referenced entry’s id. */
             entryUid: string;
         };
+        /** @description One version of an entry: the fields that locale stored when the version was written, at the top level and in the active schema’s order — a field since removed included, since a version is history — and `_metadata`. */
+        EntryVersion: {
+            _metadata: components['schemas']['EntryVersionMetadata'];
+        } & {
+            [key: string]: unknown;
+        };
+        /** @description What this service reports about one version of an entry. Not an entry read’s `EntryMetadata`: `version` and `locale` are the row’s own, `status` is `version`, and it carries no default or available locales, no fallback and no version list. */
+        EntryVersionMetadata: {
+            id: string;
+            /** @description The content type the version was written under. */
+            type: string;
+            /** @enum {string} */
+            entryType: 'asset' | 'content' | 'settings' | 'singleton';
+            /** @description The entry’s live slug at the version’s locale, or null when the type declares none. */
+            slug: string | null;
+            /**
+             * @description Always `version`: this is a historical row, not the entry’s lifecycle.
+             * @enum {string}
+             */
+            status: 'version';
+            /** @description The version’s own number, on `locale`’s counter. */
+            version: number;
+            /** @description The entry’s live shared-field counter. A version is not a state a write is checked against, and no `X-Entity-Tag` is minted from it. */
+            sharedVersion: number;
+            /** @description The locale the version belongs to. */
+            locale: string;
+            /**
+             * @description Publication state of `locale` on the live entry. Absent when it has no content of its own.
+             * @enum {string}
+             */
+            localeStatus?: 'archived' | 'draft' | 'published';
+            /** @description Whether `locale` has unpublished changes of its own. */
+            localeHasDraft: boolean;
+            /** @description Every locale holding unpublished content of its own, sorted. A shared-field draft is not listed: it is `hasDraft`. */
+            draftLocales: string[];
+            /** @description Whether the shared (non-localized) fields have unpublished changes. Publishing any locale makes them live, so they are unpublished work in every locale. */
+            hasDraft: boolean;
+            /**
+             * Format: date-time
+             * @description When the version was written.
+             */
+            createdAt: string;
+            /**
+             * Format: date-time
+             * @description When the version was published — the same instant as `publishedAt`.
+             */
+            updatedAt: string;
+            /**
+             * Format: date-time
+             * @description When the version was published.
+             */
+            publishedAt: string;
+            /** @description The references the version held. */
+            refs: components['schemas']['EntryRef'][];
+        };
+        /** @description One row of an entry’s version history in one locale: which version it is, who wrote it and when, and the fields that locale stored. */
+        EntryVersionRow: {
+            /** @description The version’s own number, on `locale`’s counter. */
+            versionNumber: number;
+            /** @description The locale the version belongs to. */
+            locale: string;
+            /** @description That locale’s own fields, as stored when the version was written. */
+            fields: {
+                [key: string]: unknown;
+            };
+            /**
+             * Format: date-time
+             * @description When the version was published.
+             */
+            publishedAt: string;
+            /** @description Who wrote the version. */
+            publishedBy: string;
+        };
         ErrorResponse: {
             error: {
-                /** @enum {string} */
+                /**
+                 * @description - `ACCESS_DENIED`: The credential is valid, but its subject may not do this here. Fix: Use a key or a Role that grants this action on this resource, or ask an Owner to grant it; `details.rule` names the rule that refused.
+                 *     - `AI_UNAVAILABLE_IN_REGION`: The Project's data region promises residency, and no AI processes inside that region yet. Fix: Run AI work on a Project in another region; no Plan, credential or retry changes this one.
+                 *     - `CONTENT_INVALID`: The content does not satisfy the schema of the type it was written to. Fix: Correct each field `details.issues` names so it matches the schema, then write it again.
+                 *     - `INTERNAL_ERROR`: The service failed while handling the request. Fix: Retry once; if it fails again, report it with the time and the request that failed.
+                 *     - `INVALID_API_KEY`: The credential was read but is not accepted: it is malformed, expired, revoked, unknown, or a kind this route does not take. Fix: Read `details.reason`, then send a current credential of the kind the route takes, creating a new key if this one was revoked or expired.
+                 *     - `METHOD_NOT_ALLOWED`: The route does not accept this HTTP method. Fix: Send the request with one of the methods the `Allow` header lists.
+                 *     - `MISSING_API_KEY`: The request carried no credential, or one that did not authenticate. Fix: Send a credential with the request: an API key in the `X-API-Key` header, or the bearer token the route takes.
+                 *     - `ORGANIZATION_BEING_DELETED`: The Organization is being deleted, so nothing more may be read from or written to it. Fix: Stop using the Organization: its deletion was asked for at `details.requestedAt`, and no retry succeeds.
+                 *     - `ORGANIZATION_DELETE_BLOCKED`: The Organization cannot be deleted while a paid subscription or an open checkout still holds it. Fix: Resolve what `details.reason` names: downgrade and wait for the paid period to end, or let the open checkout expire, then delete again.
+                 *     - `ORGANIZATION_IN_ANOTHER_CELL`: The request reached a region that is not the home of the Organization it names. Fix: Send the same request to the region `details.region` names; retrying it here will not succeed.
+                 *     - `PAYLOAD_TOO_LARGE`: The request body is larger than the route accepts. Fix: Send a body within `details.limitBytes`, splitting the work across several requests.
+                 *     - `PLAN_DOWNGRADE_BLOCKED`: The Organization keeps more than the target Plan allows, so it cannot move to it. Fix: Reduce each Stock Limit `details.stockLimits` lists to within the target Plan, then retry the change.
+                 *     - `PLAN_FEATURE_UNAVAILABLE`: The Organization's Plan does not include the feature this request uses. Fix: Move the Organization to a Plan that includes `details.feature`, or leave the feature out of the request.
+                 *     - `PROJECT_IN_ANOTHER_CELL`: The request reached a region that does not hold the Project it names. Fix: Send the same request to the region `details.region` names; retrying it here will not succeed.
+                 *     - `RATE_LIMIT_EXCEEDED`: Too many requests arrived within the current rate-limit window. Fix: Wait the seconds the `Retry-After` header names before retrying, and spread requests out.
+                 *     - `READ_ONLY_KEY`: The key may read but not write. Fix: Send the write with a key that may write, and keep the read-only key for reads.
+                 *     - `REQUEST_INVALID`: The request is malformed: a path parameter, query parameter, header or body field the route cannot accept. Fix: Correct each field `details.issues` names, by its path and message, and send the request again.
+                 *     - `REQUEST_TIMEOUT`: The request ran longer than the service allows and was stopped. Fix: Ask for less in one request, with a narrower filter or a smaller page, then retry.
+                 *     - `RESOURCE_CONFLICT`: The write conflicts with the resource's current state: it changed since it was read, or something stands in the way. Fix: Re-read the resource and retry with what that read returns, or resolve the blockage `details.blockage` names.
+                 *     - `RESOURCE_EXPIRED`: What the request names existed but has expired: a cursor the feed can no longer replay from, or an invitation or link past its date. Fix: Start again without it: read afresh instead of from the cursor, or ask for a new invitation or link.
+                 *     - `RESOURCE_NOT_FOUND`: Nothing the credential can see exists under that id or path. Fix: Check the id, the path and the dataset the request selects; `details.kind` names what was looked for.
+                 *     - `REVERIFICATION_REQUIRED`: The action hands authority out, and the session verified its factor too long ago. Fix: Have the User verify again at the level `details.level` names, then retry the request.
+                 *     - `SERVICE_INDETERMINATE`: A service this request depends on could not answer, so the outcome could not be decided. Fix: Retry after the seconds the `Retry-After` header names; `details.missing` names what was unavailable.
+                 *     - `TRANSACTION_ROLLED_BACK`: One operation of an all-or-nothing batch failed, so none of the batch was applied. Fix: Nothing was written. `details.failedIndex` is the index of the operation this refusal is for, which is not necessarily the one that failed. Fix the batch, then send the whole of it again.
+                 *     - `USAGE_QUOTA_EXCEEDED`: The Organization has used all of this period's allowance for `details.meter`. Fix: Wait for the next billing period, or raise the allowance by moving to a larger Plan.
+                 *     - `USER_NOT_PROVISIONED`: The session is valid, but the User's account is still being set up after sign-up. Fix: Keep the session and retry after the seconds the `Retry-After` header names.
+                 * @enum {string}
+                 */
                 code: 'ACCESS_DENIED' | 'AI_UNAVAILABLE_IN_REGION' | 'CONTENT_INVALID' | 'INTERNAL_ERROR' | 'INVALID_API_KEY' | 'METHOD_NOT_ALLOWED' | 'MISSING_API_KEY' | 'ORGANIZATION_BEING_DELETED' | 'ORGANIZATION_DELETE_BLOCKED' | 'ORGANIZATION_IN_ANOTHER_CELL' | 'PAYLOAD_TOO_LARGE' | 'PLAN_DOWNGRADE_BLOCKED' | 'PLAN_FEATURE_UNAVAILABLE' | 'PROJECT_IN_ANOTHER_CELL' | 'RATE_LIMIT_EXCEEDED' | 'READ_ONLY_KEY' | 'REQUEST_INVALID' | 'REQUEST_TIMEOUT' | 'RESOURCE_CONFLICT' | 'RESOURCE_EXPIRED' | 'RESOURCE_NOT_FOUND' | 'REVERIFICATION_REQUIRED' | 'SERVICE_INDETERMINATE' | 'TRANSACTION_ROLLED_BACK' | 'USAGE_QUOTA_EXCEEDED' | 'USER_NOT_PROVISIONED';
                 messages: string[];
                 details?: {
@@ -1390,7 +1567,10 @@ interface components {
         };
         RefusalAccessDenied: {
             error: {
-                /** @enum {string} */
+                /**
+                 * @description - `ACCESS_DENIED`: The credential is valid, but its subject may not do this here. Fix: Use a key or a Role that grants this action on this resource, or ask an Owner to grant it; `details.rule` names the rule that refused.
+                 * @enum {string}
+                 */
                 code: 'ACCESS_DENIED';
                 messages: string[];
                 details?: {
@@ -1400,7 +1580,13 @@ interface components {
         };
         RefusalAccessDeniedOrPlanFeatureUnavailableOrReadOnlyKeyOrUsageQuotaExceeded: {
             error: {
-                /** @enum {string} */
+                /**
+                 * @description - `ACCESS_DENIED`: The credential is valid, but its subject may not do this here. Fix: Use a key or a Role that grants this action on this resource, or ask an Owner to grant it; `details.rule` names the rule that refused.
+                 *     - `PLAN_FEATURE_UNAVAILABLE`: The Organization's Plan does not include the feature this request uses. Fix: Move the Organization to a Plan that includes `details.feature`, or leave the feature out of the request.
+                 *     - `READ_ONLY_KEY`: The key may read but not write. Fix: Send the write with a key that may write, and keep the read-only key for reads.
+                 *     - `USAGE_QUOTA_EXCEEDED`: The Organization has used all of this period's allowance for `details.meter`. Fix: Wait for the next billing period, or raise the allowance by moving to a larger Plan.
+                 * @enum {string}
+                 */
                 code: 'ACCESS_DENIED' | 'PLAN_FEATURE_UNAVAILABLE' | 'READ_ONLY_KEY' | 'USAGE_QUOTA_EXCEEDED';
                 messages: string[];
                 details?: {
@@ -1410,7 +1596,12 @@ interface components {
         };
         RefusalAccessDeniedOrPlanFeatureUnavailableOrUsageQuotaExceeded: {
             error: {
-                /** @enum {string} */
+                /**
+                 * @description - `ACCESS_DENIED`: The credential is valid, but its subject may not do this here. Fix: Use a key or a Role that grants this action on this resource, or ask an Owner to grant it; `details.rule` names the rule that refused.
+                 *     - `PLAN_FEATURE_UNAVAILABLE`: The Organization's Plan does not include the feature this request uses. Fix: Move the Organization to a Plan that includes `details.feature`, or leave the feature out of the request.
+                 *     - `USAGE_QUOTA_EXCEEDED`: The Organization has used all of this period's allowance for `details.meter`. Fix: Wait for the next billing period, or raise the allowance by moving to a larger Plan.
+                 * @enum {string}
+                 */
                 code: 'ACCESS_DENIED' | 'PLAN_FEATURE_UNAVAILABLE' | 'USAGE_QUOTA_EXCEEDED';
                 messages: string[];
                 details?: {
@@ -1420,7 +1611,11 @@ interface components {
         };
         RefusalContentInvalidOrRequestInvalid: {
             error: {
-                /** @enum {string} */
+                /**
+                 * @description - `CONTENT_INVALID`: The content does not satisfy the schema of the type it was written to. Fix: Correct each field `details.issues` names so it matches the schema, then write it again.
+                 *     - `REQUEST_INVALID`: The request is malformed: a path parameter, query parameter, header or body field the route cannot accept. Fix: Correct each field `details.issues` names, by its path and message, and send the request again.
+                 * @enum {string}
+                 */
                 code: 'CONTENT_INVALID' | 'REQUEST_INVALID';
                 messages: string[];
                 details?: {
@@ -1430,7 +1625,10 @@ interface components {
         };
         RefusalInternalError: {
             error: {
-                /** @enum {string} */
+                /**
+                 * @description - `INTERNAL_ERROR`: The service failed while handling the request. Fix: Retry once; if it fails again, report it with the time and the request that failed.
+                 * @enum {string}
+                 */
                 code: 'INTERNAL_ERROR';
                 messages: string[];
                 details?: {
@@ -1440,7 +1638,11 @@ interface components {
         };
         RefusalInvalidApiKeyOrMissingApiKey: {
             error: {
-                /** @enum {string} */
+                /**
+                 * @description - `INVALID_API_KEY`: The credential was read but is not accepted: it is malformed, expired, revoked, unknown, or a kind this route does not take. Fix: Read `details.reason`, then send a current credential of the kind the route takes, creating a new key if this one was revoked or expired.
+                 *     - `MISSING_API_KEY`: The request carried no credential, or one that did not authenticate. Fix: Send a credential with the request: an API key in the `X-API-Key` header, or the bearer token the route takes.
+                 * @enum {string}
+                 */
                 code: 'INVALID_API_KEY' | 'MISSING_API_KEY';
                 messages: string[];
                 details?: {
@@ -1450,7 +1652,10 @@ interface components {
         };
         RefusalProjectInAnotherCell: {
             error: {
-                /** @enum {string} */
+                /**
+                 * @description - `PROJECT_IN_ANOTHER_CELL`: The request reached a region that does not hold the Project it names. Fix: Send the same request to the region `details.region` names; retrying it here will not succeed.
+                 * @enum {string}
+                 */
                 code: 'PROJECT_IN_ANOTHER_CELL';
                 messages: string[];
                 details: {
@@ -1461,7 +1666,10 @@ interface components {
         };
         RefusalRateLimitExceeded: {
             error: {
-                /** @enum {string} */
+                /**
+                 * @description - `RATE_LIMIT_EXCEEDED`: Too many requests arrived within the current rate-limit window. Fix: Wait the seconds the `Retry-After` header names before retrying, and spread requests out.
+                 * @enum {string}
+                 */
                 code: 'RATE_LIMIT_EXCEEDED';
                 messages: string[];
                 details?: {
@@ -1471,7 +1679,10 @@ interface components {
         };
         RefusalRequestInvalid: {
             error: {
-                /** @enum {string} */
+                /**
+                 * @description - `REQUEST_INVALID`: The request is malformed: a path parameter, query parameter, header or body field the route cannot accept. Fix: Correct each field `details.issues` names, by its path and message, and send the request again.
+                 * @enum {string}
+                 */
                 code: 'REQUEST_INVALID';
                 messages: string[];
                 details?: {
@@ -1481,7 +1692,10 @@ interface components {
         };
         RefusalRequestTimeout: {
             error: {
-                /** @enum {string} */
+                /**
+                 * @description - `REQUEST_TIMEOUT`: The request ran longer than the service allows and was stopped. Fix: Ask for less in one request, with a narrower filter or a smaller page, then retry.
+                 * @enum {string}
+                 */
                 code: 'REQUEST_TIMEOUT';
                 messages: string[];
                 details?: {
@@ -1491,7 +1705,10 @@ interface components {
         };
         RefusalResourceConflict: {
             error: {
-                /** @enum {string} */
+                /**
+                 * @description - `RESOURCE_CONFLICT`: The write conflicts with the resource's current state: it changed since it was read, or something stands in the way. Fix: Re-read the resource and retry with what that read returns, or resolve the blockage `details.blockage` names.
+                 * @enum {string}
+                 */
                 code: 'RESOURCE_CONFLICT';
                 messages: string[];
                 details?: {
@@ -1499,19 +1716,44 @@ interface components {
                 };
             };
         };
-        RefusalResourceExpired: {
+        RefusalResourceConflictNamingDraftExistsBlockageOrReleaseLockedBlockageOrSlugTakenBlockage: {
             error: {
-                /** @enum {string} */
-                code: 'RESOURCE_EXPIRED';
+                /**
+                 * @description - `RESOURCE_CONFLICT`: The write conflicts with the resource's current state: it changed since it was read, or something stands in the way. Fix: Re-read the resource and retry with what that read returns, or resolve the blockage `details.blockage` names.
+                 * @enum {string}
+                 */
+                code: 'RESOURCE_CONFLICT';
                 messages: string[];
                 details?: {
+                    blockage?: components['schemas']['DraftExistsBlockage'] | components['schemas']['ReleaseLockedBlockage'] | components['schemas']['SlugTakenBlockage'];
+                } & {
                     [key: string]: unknown;
                 };
             };
         };
+        RefusalResourceExpired: {
+            error: {
+                /**
+                 * @description - `RESOURCE_EXPIRED`: What the request names existed but has expired: a cursor the feed can no longer replay from, or an invitation or link past its date. Fix: Start again without it: read afresh instead of from the cursor, or ask for a new invitation or link.
+                 * @enum {string}
+                 */
+                code: 'RESOURCE_EXPIRED';
+                messages: string[];
+                details: {
+                    /**
+                     * @description `retention` and `dataset-replaced`: the changes feed cannot replay from the cursor. `version-pruned` and `superseded`: an idempotent replay cannot reproduce the original answer, though the original write happened. `past-expiry`: an invitation past its date.
+                     * @enum {string}
+                     */
+                    reason: 'dataset-replaced' | 'past-expiry' | 'retention' | 'superseded' | 'version-pruned';
+                };
+            };
+        };
         RefusalResourceNotFound: {
             error: {
-                /** @enum {string} */
+                /**
+                 * @description - `RESOURCE_NOT_FOUND`: Nothing the credential can see exists under that id or path. Fix: Check the id, the path and the dataset the request selects; `details.kind` names what was looked for.
+                 * @enum {string}
+                 */
                 code: 'RESOURCE_NOT_FOUND';
                 messages: string[];
                 details?: {
@@ -1521,7 +1763,10 @@ interface components {
         };
         RefusalServiceIndeterminate: {
             error: {
-                /** @enum {string} */
+                /**
+                 * @description - `SERVICE_INDETERMINATE`: A service this request depends on could not answer, so the outcome could not be decided. Fix: Retry after the seconds the `Retry-After` header names; `details.missing` names what was unavailable.
+                 * @enum {string}
+                 */
                 code: 'SERVICE_INDETERMINATE';
                 messages: string[];
                 details?: {
@@ -1529,6 +1774,12 @@ interface components {
                 };
             };
         };
+        /** @description A scheduled release holds the entry and refuses edits to it until the release publishes or lets it go. */
+        ReleaseLockedBlockage: {
+            /** @enum {string} */
+            kind: 'release-locked';
+            facts: Record<string, never>;
+        };
         /** @description The entry after a restore: its fields at the top level and `_metadata`, which also lists what the restore left out and the links other entries publish that it left pointing nowhere. */
         RestoredEntry: {
             _metadata: components['schemas']['RestoredEntryMetadata'];
@@ -1582,7 +1833,7 @@ interface components {
             emptyRequiredFields?: string[];
             /** @description Every locale the entry has content in, the default first. */
             availableLocales: components['schemas']['EntryLocale'][];
-            /** @description The fields of every other locale asked for, keyed by locale — on `?locales=a,b` and `?locale=*`. A locale with no visible fields is left out. */
+            /** @description The fields of every other locale asked for, keyed by locale. Present on every `?locale=*` or `?locales=` read — `{}` when no other locale has visible fields — and absent on a single-locale read. A locale with no visible fields is left out. */
             localizations?: {
                 [key: string]: {
                     [key: string]: unknown;
@@ -1668,7 +1919,7 @@ interface components {
             emptyRequiredFields?: string[];
             /** @description Every locale the entry has content in, the default first. */
             availableLocales: components['schemas']['EntryLocale'][];
-            /** @description The fields of every other locale asked for, keyed by locale — on `?locales=a,b` and `?locale=*`. A locale with no visible fields is left out. */
+            /** @description The fields of every other locale asked for, keyed by locale. Present on every `?locale=*` or `?locales=` read — `{}` when no other locale has visible fields — and absent on a single-locale read. A locale with no visible fields is left out. */
             localizations?: {
                 [key: string]: {
                     [key: string]: unknown;
@@ -2022,11 +2273,56 @@ interface components {
             /** @description Each required field the singleton holds no value for, which this read filled with its kind’s empty value, as a value path naming a list item by its key — as on an entry. Absent when none was. */
             emptyRequiredFields?: string[];
         };
+        /** @description Another entry holds the slug this write would store, in the locale `facts` names. Choose another slug. */
+        SlugTakenBlockage: {
+            /** @enum {string} */
+            kind: 'slug-taken';
+            facts: {
+                /** @description The slug field, as a `CONTENT_INVALID` issue names it: with the locale for a localized slug (`slug.fr-FR`), without one for a shared slug. */
+                path: string;
+                /** @enum {string} */
+                code: 'SLUG_TAKEN';
+                /** @description The locale whose slug collided. A shared slug is reserved in every locale its entry has, so it names one too. */
+                locale: string;
+                /** @description The slug another entry holds. */
+                slug: string;
+                /** @description The entry holding the slug in that locale. */
+                entryId: string;
+            };
+        };
         SubFailure: {
             index: number;
             id?: string;
             error: {
-                /** @enum {string} */
+                /**
+                 * @description - `ACCESS_DENIED`: The credential is valid, but its subject may not do this here. Fix: Use a key or a Role that grants this action on this resource, or ask an Owner to grant it; `details.rule` names the rule that refused.
+                 *     - `AI_UNAVAILABLE_IN_REGION`: The Project's data region promises residency, and no AI processes inside that region yet. Fix: Run AI work on a Project in another region; no Plan, credential or retry changes this one.
+                 *     - `CONTENT_INVALID`: The content does not satisfy the schema of the type it was written to. Fix: Correct each field `details.issues` names so it matches the schema, then write it again.
+                 *     - `INTERNAL_ERROR`: The service failed while handling the request. Fix: Retry once; if it fails again, report it with the time and the request that failed.
+                 *     - `INVALID_API_KEY`: The credential was read but is not accepted: it is malformed, expired, revoked, unknown, or a kind this route does not take. Fix: Read `details.reason`, then send a current credential of the kind the route takes, creating a new key if this one was revoked or expired.
+                 *     - `METHOD_NOT_ALLOWED`: The route does not accept this HTTP method. Fix: Send the request with one of the methods the `Allow` header lists.
+                 *     - `MISSING_API_KEY`: The request carried no credential, or one that did not authenticate. Fix: Send a credential with the request: an API key in the `X-API-Key` header, or the bearer token the route takes.
+                 *     - `ORGANIZATION_BEING_DELETED`: The Organization is being deleted, so nothing more may be read from or written to it. Fix: Stop using the Organization: its deletion was asked for at `details.requestedAt`, and no retry succeeds.
+                 *     - `ORGANIZATION_DELETE_BLOCKED`: The Organization cannot be deleted while a paid subscription or an open checkout still holds it. Fix: Resolve what `details.reason` names: downgrade and wait for the paid period to end, or let the open checkout expire, then delete again.
+                 *     - `ORGANIZATION_IN_ANOTHER_CELL`: The request reached a region that is not the home of the Organization it names. Fix: Send the same request to the region `details.region` names; retrying it here will not succeed.
+                 *     - `PAYLOAD_TOO_LARGE`: The request body is larger than the route accepts. Fix: Send a body within `details.limitBytes`, splitting the work across several requests.
+                 *     - `PLAN_DOWNGRADE_BLOCKED`: The Organization keeps more than the target Plan allows, so it cannot move to it. Fix: Reduce each Stock Limit `details.stockLimits` lists to within the target Plan, then retry the change.
+                 *     - `PLAN_FEATURE_UNAVAILABLE`: The Organization's Plan does not include the feature this request uses. Fix: Move the Organization to a Plan that includes `details.feature`, or leave the feature out of the request.
+                 *     - `PROJECT_IN_ANOTHER_CELL`: The request reached a region that does not hold the Project it names. Fix: Send the same request to the region `details.region` names; retrying it here will not succeed.
+                 *     - `RATE_LIMIT_EXCEEDED`: Too many requests arrived within the current rate-limit window. Fix: Wait the seconds the `Retry-After` header names before retrying, and spread requests out.
+                 *     - `READ_ONLY_KEY`: The key may read but not write. Fix: Send the write with a key that may write, and keep the read-only key for reads.
+                 *     - `REQUEST_INVALID`: The request is malformed: a path parameter, query parameter, header or body field the route cannot accept. Fix: Correct each field `details.issues` names, by its path and message, and send the request again.
+                 *     - `REQUEST_TIMEOUT`: The request ran longer than the service allows and was stopped. Fix: Ask for less in one request, with a narrower filter or a smaller page, then retry.
+                 *     - `RESOURCE_CONFLICT`: The write conflicts with the resource's current state: it changed since it was read, or something stands in the way. Fix: Re-read the resource and retry with what that read returns, or resolve the blockage `details.blockage` names.
+                 *     - `RESOURCE_EXPIRED`: What the request names existed but has expired: a cursor the feed can no longer replay from, or an invitation or link past its date. Fix: Start again without it: read afresh instead of from the cursor, or ask for a new invitation or link.
+                 *     - `RESOURCE_NOT_FOUND`: Nothing the credential can see exists under that id or path. Fix: Check the id, the path and the dataset the request selects; `details.kind` names what was looked for.
+                 *     - `REVERIFICATION_REQUIRED`: The action hands authority out, and the session verified its factor too long ago. Fix: Have the User verify again at the level `details.level` names, then retry the request.
+                 *     - `SERVICE_INDETERMINATE`: A service this request depends on could not answer, so the outcome could not be decided. Fix: Retry after the seconds the `Retry-After` header names; `details.missing` names what was unavailable.
+                 *     - `TRANSACTION_ROLLED_BACK`: One operation of an all-or-nothing batch failed, so none of the batch was applied. Fix: Nothing was written. `details.failedIndex` is the index of the operation this refusal is for, which is not necessarily the one that failed. Fix the batch, then send the whole of it again.
+                 *     - `USAGE_QUOTA_EXCEEDED`: The Organization has used all of this period's allowance for `details.meter`. Fix: Wait for the next billing period, or raise the allowance by moving to a larger Plan.
+                 *     - `USER_NOT_PROVISIONED`: The session is valid, but the User's account is still being set up after sign-up. Fix: Keep the session and retry after the seconds the `Retry-After` header names.
+                 * @enum {string}
+                 */
                 code: 'ACCESS_DENIED' | 'AI_UNAVAILABLE_IN_REGION' | 'CONTENT_INVALID' | 'INTERNAL_ERROR' | 'INVALID_API_KEY' | 'METHOD_NOT_ALLOWED' | 'MISSING_API_KEY' | 'ORGANIZATION_BEING_DELETED' | 'ORGANIZATION_DELETE_BLOCKED' | 'ORGANIZATION_IN_ANOTHER_CELL' | 'PAYLOAD_TOO_LARGE' | 'PLAN_DOWNGRADE_BLOCKED' | 'PLAN_FEATURE_UNAVAILABLE' | 'PROJECT_IN_ANOTHER_CELL' | 'RATE_LIMIT_EXCEEDED' | 'READ_ONLY_KEY' | 'REQUEST_INVALID' | 'REQUEST_TIMEOUT' | 'RESOURCE_CONFLICT' | 'RESOURCE_EXPIRED' | 'RESOURCE_NOT_FOUND' | 'REVERIFICATION_REQUIRED' | 'SERVICE_INDETERMINATE' | 'TRANSACTION_ROLLED_BACK' | 'USAGE_QUOTA_EXCEEDED' | 'USER_NOT_PROVISIONED';
                 messages: string[];
                 details?: {
@@ -2897,8 +3193,7 @@ interface operations {
                 };
                 content: {
                     'application/json': {
-                        /** @description The payload itself. */
-                        data: unknown;
+                        data: components['schemas']['Entry'];
                     };
                 };
             };
@@ -2944,7 +3239,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['RefusalResourceConflict'];
+                    'application/json': components['schemas']['RefusalResourceConflictNamingDraftExistsBlockageOrReleaseLockedBlockageOrSlugTakenBlockage'];
                 };
             };
             /** @description RESOURCE_EXPIRED */
@@ -3173,7 +3468,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['RefusalResourceConflict'];
+                    'application/json': components['schemas']['RefusalResourceConflictNamingDraftExistsBlockageOrReleaseLockedBlockageOrSlugTakenBlockage'];
                 };
             };
             /** @description RESOURCE_EXPIRED */
@@ -3291,7 +3586,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['RefusalResourceConflict'];
+                    'application/json': components['schemas']['RefusalResourceConflictNamingDraftExistsBlockageOrReleaseLockedBlockageOrSlugTakenBlockage'];
                 };
             };
             /** @description RESOURCE_EXPIRED */
@@ -3488,13 +3783,13 @@ interface operations {
                     };
                 };
             };
-            /** @description CONTENT_INVALID, REQUEST_INVALID */
+            /** @description REQUEST_INVALID */
             400: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['RefusalContentInvalidOrRequestInvalid'];
+                    'application/json': components['schemas']['RefusalRequestInvalid'];
                 };
             };
             /** @description INVALID_API_KEY, MISSING_API_KEY */
@@ -4709,6 +5004,125 @@ interface operations {
             };
         };
     };
+    restoreSharedEntryVersion: {
+        parameters: {
+            query?: never;
+            header?: {
+                'Idempotency-Key'?: string;
+                'If-Match'?: string;
+            };
+            path: {
+                contentType: string;
+                id: string;
+                versionNumber: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Success. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': {
+                        data: components['schemas']['RestoredEntry'];
+                    };
+                };
+            };
+            /** @description CONTENT_INVALID, REQUEST_INVALID */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['RefusalContentInvalidOrRequestInvalid'];
+                };
+            };
+            /** @description INVALID_API_KEY, MISSING_API_KEY */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['RefusalInvalidApiKeyOrMissingApiKey'];
+                };
+            };
+            /** @description ACCESS_DENIED, PLAN_FEATURE_UNAVAILABLE, READ_ONLY_KEY, USAGE_QUOTA_EXCEEDED */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['RefusalAccessDeniedOrPlanFeatureUnavailableOrReadOnlyKeyOrUsageQuotaExceeded'];
+                };
+            };
+            /** @description RESOURCE_NOT_FOUND */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['RefusalResourceNotFound'];
+                };
+            };
+            /** @description RESOURCE_CONFLICT */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['RefusalResourceConflictNamingDraftExistsBlockageOrReleaseLockedBlockageOrSlugTakenBlockage'];
+                };
+            };
+            /** @description RESOURCE_EXPIRED */
+            410: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['RefusalResourceExpired'];
+                };
+            };
+            /** @description PROJECT_IN_ANOTHER_CELL */
+            421: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['RefusalProjectInAnotherCell'];
+                };
+            };
+            /** @description RATE_LIMIT_EXCEEDED */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['RefusalRateLimitExceeded'];
+                };
+            };
+            /** @description INTERNAL_ERROR */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['RefusalInternalError'];
+                };
+            };
+            /** @description SERVICE_INDETERMINATE */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['RefusalServiceIndeterminate'];
+                };
+            };
+        };
+    };
     getEntryVersions: {
         parameters: {
             query?: {
@@ -4733,8 +5147,7 @@ interface operations {
                 };
                 content: {
                     'application/json': {
-                        /** @description The payload itself. */
-                        data: unknown;
+                        data: components['schemas']['EntryVersionRow'][];
                     };
                 };
             };
@@ -4835,8 +5248,7 @@ interface operations {
                 };
                 content: {
                     'application/json': {
-                        /** @description The payload itself. */
-                        data: unknown;
+                        data: components['schemas']['EntryVersion'];
                     };
                 };
             };
@@ -4983,7 +5395,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['RefusalResourceConflict'];
+                    'application/json': components['schemas']['RefusalResourceConflictNamingDraftExistsBlockageOrReleaseLockedBlockageOrSlugTakenBlockage'];
                 };
             };
             /** @description RESOURCE_EXPIRED */
@@ -6006,6 +6418,8 @@ interface operations {
     runSavedQuery: {
         parameters: {
             query?: {
+                /** @description A changes-feed cursor at or after the change this read follows — the `fresh` a change carries in `@relyio/sdk`. The answer is the read’s own, unchanged; the term only makes the request one that no cache holds an answer to from before that change. A value that is not a cursor the feed issued is refused. */
+                _fresh?: string;
                 /** @description The locale to read. Outranks `Accept-Language`. */
                 locale?: string;
             };
@@ -6020,6 +6434,10 @@ interface operations {
             /** @description Success. */
             200: {
                 headers: {
+                    'Cache-Control'?: string;
+                    ETag?: string;
+                    Vary?: string;
+                    'X-Cache'?: string;
                     [name: string]: unknown;
                 };
                 content: {
@@ -6115,6 +6533,8 @@ interface operations {
     runSavedQueryWithBody: {
         parameters: {
             query?: {
+                /** @description A changes-feed cursor at or after the change this read follows — the `fresh` a change carries in `@relyio/sdk`. The answer is the read’s own, unchanged; the term only makes the request one that no cache holds an answer to from before that change. A value that is not a cursor the feed issued is refused. */
+                _fresh?: string;
                 /** @description The locale to read. Outranks `Accept-Language`. */
                 locale?: string;
             };
@@ -6129,6 +6549,8 @@ interface operations {
             /** @description Success. */
             200: {
                 headers: {
+                    'Cache-Control'?: string;
+                    'X-Cache'?: string;
                     [name: string]: unknown;
                 };
                 content: {
@@ -6226,6 +6648,12 @@ interface operations {
             query?: {
                 /** @description A changes-feed cursor at or after the change this read follows — the `fresh` a change carries in `@relyio/sdk`. The answer is the read’s own, unchanged; the term only makes the request one that no cache holds an answer to from before that change. A value that is not a cursor the feed issued is refused. */
                 _fresh?: string;
+                /** @description Return the page after this one: the `page.nextCursor` of the previous answer. Absent, the first page. Only a fetch pages; a cursor is refused on a query that is not one. */
+                cursor?: string;
+                /** @description The locale to read. Outranks `Accept-Language`. Use `*` to retrieve every locale: the default at the top level and the rest in `_metadata.localizations`. */
+                locale?: string;
+                /** @description Comma-separated locales to retrieve. The first is the primary, composed at the top level; the rest go in `_metadata.localizations`. */
+                locales?: string;
             };
             header?: never;
             path?: never;
@@ -6242,8 +6670,11 @@ interface operations {
                 };
                 content: {
                     'application/json': {
-                        /** @description The payload itself. */
-                        data: unknown;
+                        data: unknown[];
+                        page: components['schemas']['CursorPage'];
+                        meta: {
+                            [key: string]: unknown;
+                        };
                     };
                 };
             };
@@ -6919,7 +7350,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['RefusalResourceConflict'];
+                    'application/json': components['schemas']['RefusalResourceConflictNamingDraftExistsBlockageOrReleaseLockedBlockageOrSlugTakenBlockage'];
                 };
             };
             /** @description RESOURCE_EXPIRED */
@@ -7138,7 +7569,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['RefusalResourceConflict'];
+                    'application/json': components['schemas']['RefusalResourceConflictNamingDraftExistsBlockageOrReleaseLockedBlockageOrSlugTakenBlockage'];
                 };
             };
             /** @description RESOURCE_EXPIRED */
@@ -7211,8 +7642,7 @@ interface operations {
                 };
                 content: {
                     'application/json': {
-                        /** @description The payload itself. */
-                        data: unknown;
+                        data: components['schemas']['DocumentVersionHistory'];
                     };
                 };
             };
@@ -7312,8 +7742,7 @@ interface operations {
                 };
                 content: {
                     'application/json': {
-                        /** @description The payload itself. */
-                        data: unknown;
+                        data: components['schemas']['DocumentVersion'];
                     };
                 };
             };
@@ -7566,7 +7995,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['RefusalResourceConflict'];
+                    'application/json': components['schemas']['RefusalResourceConflictNamingDraftExistsBlockageOrReleaseLockedBlockageOrSlugTakenBlockage'];
                 };
             };
             /** @description RESOURCE_EXPIRED */
@@ -7736,8 +8165,7 @@ interface operations {
                 };
                 content: {
                     'application/json': {
-                        /** @description The payload itself. */
-                        data: unknown;
+                        data: components['schemas']['DocumentVersionHistory'];
                     };
                 };
             };
@@ -7837,8 +8265,7 @@ interface operations {
                 };
                 content: {
                     'application/json': {
-                        /** @description The payload itself. */
-                        data: unknown;
+                        data: components['schemas']['DocumentVersion'];
                     };
                 };
             };
@@ -7934,7 +8361,15 @@ interface RelyIOConfig {
     apiKey: string;
     /** Base URL for the RelyIO API */
     baseUrl?: string;
-    /** Dataset to use */
+    /**
+     * Dataset to use, sent as `X-RelyIO-Dataset` — an id or a name.
+     *
+     * Which dataset a client reads, first match wins: an active `relyio dev` sandbox; this option; on
+     * a host preview deployment (`VERCEL_ENV=preview`) and with a preview key (`rly_prev_…`), the pull
+     * request's preview, `previewDatasetSlug(VERCEL_GIT_COMMIT_REF)` from `@relyio/sdk/preview` —
+     * never in production, never with a published key, and, once the api answers that no such preview
+     * exists, never again in that process; the key's own default.
+     */
     dataset?: string;
     /**
      * Default locale for all content queries
@@ -7972,8 +8407,6 @@ interface RelyIOConfig {
      * turn off under a framework that caches `fetch` itself (Next.js).
      */
     cache?: CacheConfig;
-    /** Real-time configuration */
-    realtime?: RealtimeConfig;
     /** Debug configuration */
     debug?: DebugConfig;
     /** Custom headers to include with requests */
@@ -8072,7 +8505,6 @@ type LiveWebSocketConstructor = new (url: string) => LiveWebSocket;
 type RelyIOConfigUpdate = Update<Omit<RelyIOConfig, OptionBag | 'headers'>, UndefaultedOption> & {
     browser?: Update<BrowserConfig, UndefaultedField['browser']>;
     cache?: Update<CacheConfig, UndefaultedField['cache']>;
-    realtime?: Update<RealtimeConfig, UndefaultedField['realtime']>;
     debug?: Update<DebugConfig, UndefaultedField['debug']>;
     /** Headers to add or replace, each kept until named again; `null` stops sending that header. */
     headers?: Record<string, string | null>;
@@ -8093,18 +8525,6 @@ interface CacheConfig {
     /** Cache strategies to use */
     strategies?: CacheStrategy[];
 }
-interface RealtimeConfig {
-    /** Whether real-time features are enabled (defaults to true) */
-    enabled?: boolean;
-    /** WebSocket URL for real-time connections */
-    wsUrl?: string;
-    /** Maximum number of reconnection attempts (defaults to 10) */
-    maxReconnectAttempts?: number;
-    /** Reconnection delay in milliseconds (defaults to 1000) */
-    reconnectDelay?: number;
-    /** Heartbeat interval in milliseconds (defaults to 30000) */
-    heartbeatInterval?: number;
-}
 interface DebugConfig {
     /** Whether debug mode is enabled (defaults to false) */
     enabled?: boolean;
@@ -8225,7 +8645,7 @@ type WithDefaults<T, NoDefault extends keyof T = never> = Required<Omit<T, NoDef
  */
 type UndefaultedOption = 'apiKey' | 'dataset' | 'locale' | 'dev' | 'fetch' | 'liveUrl' | 'webSocket';
 /** The options that are themselves bags of options, each merged field by field. */
-type OptionBag = 'browser' | 'cache' | 'realtime' | 'debug';
+type OptionBag = 'browser' | 'cache' | 'debug';
 /**
  * The fields of each bag with no default, absent from a merged configuration until the caller gives
  * one — and the fields of a bag `updateConfig()` can clear with `null`.
@@ -8233,20 +8653,18 @@ type OptionBag = 'browser' | 'cache' | 'realtime' | 'debug';
 interface UndefaultedField {
     browser: 'onCorsError';
     cache: never;
-    realtime: 'wsUrl';
     debug: 'logger';
 }
 /**
  * The value each option takes when the caller gives none, down to each field of each bag — so a
  * field of a merged configuration that has a default is never `undefined`, and a reader does not
- * restate the default. A field with no default (`onCorsError`, `wsUrl`, `logger`) is named in
+ * restate the default. A field with no default (`onCorsError`, `logger`) is named in
  * {@link UndefaultedField}; a field added to a bag without one fails to compile at
  * {@link DEFAULT_CONFIG} until it gets a default or a name there.
  */
 type ConfigDefaults = WithDefaults<Omit<RelyIOConfig, UndefaultedOption | OptionBag>> & {
     browser: WithDefaults<BrowserConfig, UndefaultedField['browser']>;
     cache: WithDefaults<CacheConfig, UndefaultedField['cache']>;
-    realtime: WithDefaults<RealtimeConfig, UndefaultedField['realtime']>;
     debug: WithDefaults<DebugConfig, UndefaultedField['debug']>;
 };
 /** The configuration a client runs on: each option the caller gave, and its default where not. */
@@ -10037,7 +10455,16 @@ declare abstract class SDKError extends Error {
      */
     isType(errorType: string): boolean;
     /**
-     * Create a new error with additional context
+     * Create a copy of this error with additional context.
+     *
+     * The copy is made from this error's own properties, not by calling a constructor: subclasses
+     * declare constructors of their own (violations, a timeout, a feature, a failed index second),
+     * and no single argument order fits them all. Rebuilding through the base order put the status
+     * code in the subclass's second slot. Copying keeps every field, the subclass's own included, and
+     * the original `timestamp` and `stack`, since it is the same failure.
+     *
+     * `Object.create` runs no constructor, so a `#private` field would not survive the copy; none
+     * exist in this directory. `stack` is not an own property on V8 and is copied by hand below.
      */
     withContext(context: Record<string, unknown>): this;
 }
@@ -10159,8 +10586,13 @@ type ViewScopeConfig = ContentTypeScopeConfig | ContentTypesScopeConfig | EntryT
  * written here, so a view pulled by `relyio generate-types` that named one did not compile.
  * `@relyio/codegen-typescript`'s `src/__tests__/sdk-definition-config.types.ts` holds the two to each
  * other (REL-1457).
+ *
+ * Only spellings some field accepts (REL-1697): `isTrue`, `isFalse`, `today`, `yesterday`,
+ * `thisWeek`, `thisMonth`, `thisYear`, `includes` and `notIncludes` were offered here and refused at
+ * deploy on every field. A boolean is asked `is` with `true` or `false`; a date `isOn` or
+ * `inTheLast`; tags `hasValue` or `isEmpty`.
  */
-type ViewFilterOperator = 'is' | 'isNot' | 'contains' | 'notContains' | 'startsWith' | 'endsWith' | 'isAnyOf' | 'isNoneOf' | 'includes' | 'notIncludes' | 'isTrue' | 'isFalse' | 'equals' | 'notEquals' | 'greaterThan' | 'lessThan' | 'greaterThanOrEqual' | 'lessThanOrEqual' | 'between' | 'isOn' | 'isBefore' | 'isAfter' | 'isBetween' | 'inTheLast' | 'inTheNext' | 'today' | 'yesterday' | 'thisWeek' | 'thisMonth' | 'thisYear' | 'isEmpty' | 'hasValue';
+type ViewFilterOperator = 'is' | 'isNot' | 'contains' | 'notContains' | 'startsWith' | 'endsWith' | 'isAnyOf' | 'isNoneOf' | 'equals' | 'notEquals' | 'greaterThan' | 'lessThan' | 'greaterThanOrEqual' | 'lessThanOrEqual' | 'between' | 'isOn' | 'isBefore' | 'isAfter' | 'isBetween' | 'inTheLast' | 'inTheNext' | 'isEmpty' | 'hasValue';
 /** A span of time back or forward from now, for `inTheLast` and `inTheNext`. */
 interface ViewFilterRelativeDate {
     amount: number;
@@ -10480,6 +10912,24 @@ type RevisedContent<T extends BaseContent> = Omit<T, '_metadata'> & {
 type RestoredContent<T extends BaseContent> = Omit<T, '_metadata'> & {
     _metadata: T['_metadata'] & Pick<components['schemas']['RestoredEntryMetadata'], 'leftOut' | 'brokenLinks'>;
 };
+/**
+ * One version of an entry, as `version(id, { version })` reads it — the document's `EntryVersion`
+ * (REL-3181): the fields that locale stored when the version was written, at the top level, and
+ * `EntryVersionMetadata`, whose `status` is `'version'` and which names no default or available
+ * locales. Every field is optional: a locale's row holds that locale's own fields, never the shared
+ * ones.
+ */
+type ContentVersion<T extends BaseContent> = Partial<Omit<T, '_metadata'>> & {
+    _metadata: components['schemas']['EntryVersionMetadata'];
+};
+/**
+ * One row of an entry's history, as `versions(id)` lists it — the document's `EntryVersionRow`
+ * (REL-3269): which version of which locale, who wrote it and when, and the fields that locale
+ * stored, nested under `fields` — its own fields only, never the shared ones.
+ */
+type ContentVersionRow<T extends BaseContent> = Omit<components['schemas']['EntryVersionRow'], 'fields'> & {
+    fields: Partial<Omit<T, '_metadata'>>;
+};
 /**
  * Content update input - excludes system-managed metadata fields
  */
@@ -10535,7 +10985,7 @@ interface FieldDefinition {
     /** Field name */
     name: string;
     /** Field type */
-    type: FieldTypeName;
+    type: FieldKind;
     /** Display title */
     title?: string;
     /** Field description */
@@ -10549,10 +10999,6 @@ interface FieldDefinition {
     /** Field options */
     options?: FieldOptions;
 }
-/**
- * Supported field type names (string identifiers)
- */
-type FieldTypeName = 'string' | 'number' | 'boolean' | 'date' | 'datetime' | 'text' | 'markdown' | 'richtext' | 'slug' | 'url' | 'email' | 'image' | 'file' | 'reference' | 'array' | 'object' | 'geopoint' | 'color';
 /**
  * Field validation rules
  */
@@ -10711,8 +11157,12 @@ type FieldsOfShapes$2<Shape> = Shape extends {
 type TargetFields<F, S> = F extends {
     readonly config?: infer C;
 } ? S extends FieldSchemaContext ? FieldsOfDefinition<Declared$1<S['contentTypes'], ReferenceTarget<NonNullable<C>>> | Declared$1<S['singletonContentTypes'], ReferenceTarget<NonNullable<C>>> | Declared$1<NonNullable<S['assetTypes']>, ReferenceTarget<NonNullable<C>>>> : never : never;
+/**
+ * The fields a definition declares. An asset type's `fields` are optional, so they are read as
+ * optional here — a required `fields` would read every asset as `never` and accept any path (REL-2366).
+ */
 type FieldsOfDefinition<D> = D extends {
-    readonly fields: readonly unknown[];
+    readonly fields?: unknown;
 } ? DeclaredFields<D> : never;
 /** `true` when a field is a reference, or a list or object holding one at any depth. */
 type HoldsReference<F> = F extends AnyFieldDefinition ? IsReference<F> extends true ? true : true extends HoldsReference<ShapeFields<F>> ? true : true extends IsLinkingRichText<F> ? true : false : false;
@@ -10997,9 +11447,8 @@ interface AssetReading<D extends AnyAssetTypeDefinition, S extends FieldSchemaCo
     /**
      * What its `where` takes: every key the API filters its fields by, as a content type's
      * ({@link FilterPaths}) — an asset is an entry on the same routes, held to the same check (REL-2195).
-     * Its `fields` are optional, so they are read with `DeclaredFields`, which takes them so.
      */
-    readonly where: FilterPaths<DeclaredFields<D>, S>;
+    readonly where: FilterPaths<FieldsOfDefinition<D>, S>;
 }
 /** A read of the settings group `D` defines, in schema `S`. */
 interface SettingsReading<D extends AnySettingsGroupDefinition, S extends FieldSchemaContext | undefined> extends Reading {
@@ -11952,4 +12401,4 @@ type InferContentType<T extends AnyContentTypeDefinition, S extends FieldSchemaC
     _metadata: EntryMetadata;
 };
 
-export { enumField as $, type AIConfig as A, type BaseFieldConfig as B, type CodeConfig as C, type DateConfig as D, type EmailConfig as E, type FieldAIConfig as F, type RuleConditions as G, type SlugConfig as H, type IntegerConfig as I, type JsonConfig as J, type KeyedEnumConfig as K, type ListConfig as L, type TagsConfig as M, type VisibilityRule as N, type ObjectConfig as O, boolean as P, code as Q, type ReadOnlyRule as R, type ShortTextConfig as S, type TableConfig as T, type UrlConfig as U, type ValidationRule$1 as V, type WidgetOptions as W, date as X, dateTime as Y, decimal as Z, email as _, type AnyFieldDefinition as a, type AssetTypeDefinition as a$, integer as a0, json as a1, list as a2, longText as a3, object as a4, reference as a5, richText as a6, shortText as a7, slug as a8, table as a9, type TextDirection as aA, type LocaleOptions as aB, type LocaleDefinition as aC, defineContentType as aD, fieldset as aE, type Fieldset as aF, type DeclaredFieldset as aG, type AnyDeclaredFieldset as aH, type KeyedFieldsetConfig as aI, type FieldMember as aJ, type KeyedContentTypeConfig as aK, type ContentTypeDefinition as aL, type EntryMetadata as aM, type InferContentType as aN, type LocalePublicationFields as aO, defineSingleton as aP, type KeyedSingletonConfig as aQ, type SingletonContentTypeDefinition as aR, type SingletonMetadata as aS, type InferSingleton as aT, defineSettingsGroup as aU, type KeyedSettingsGroupConfig as aV, type SettingsGroupDefinition as aW, type SettingsGroupMetadata as aX, type InferSettingsGroup as aY, defineAssetType as aZ, type KeyedAssetTypeConfig as a_, tags as aa, url as ab, type FieldSchemaContext as ac, type FieldValue as ad, type FieldValues as ae, type DeclaredFields as af, type UnresolvedEntry as ag, type Keyed as ah, type BlockOf as ai, type ShapeValue as aj, type AssetReading as ak, type CheckedIncludes as al, type CheckInclude as am, type ContentReading as an, type IncludablePaths as ao, type Reading as ap, type ReadWith as aq, type SettingsReading as ar, type SingletonReading as as, type UntypedReading as at, defineLocale as au, isLocaleDefinition as av, getLocaleCodes as aw, findDefaultLocale as ax, getActiveLocales as ay, buildFallbackChain as az, type AnyKeyedField as b, type ViewFilterOperator as b$, type InferAssetType as b0, type InferAssetEntry as b1, type AssetServedBlocks as b2, type ImageKindConfig as b3, type VideoKindConfig as b4, type FileKindConfig as b5, type ImageTransform as b6, type ImageFitMode as b7, type ImageOutputFormat as b8, type ImageUploadConfig as b9, type KeyedRolesAsList as bA, defineWorkflow as bB, defineWorkflowStage as bC, defineContentTypeWorkflow as bD, isWorkflowDefinition as bE, isWorkflowStageDefinition as bF, getWorkflowStageIds as bG, findWorkflowStage as bH, getNextWorkflowStage as bI, getFirstWorkflowStage as bJ, isFinalWorkflowStage as bK, type WorkflowEscalation as bL, type WorkflowAutoAssign as bM, type WorkflowStageConfig as bN, type WorkflowStageDefinition as bO, type WorkflowDefinition as bP, type ContentTypeWorkflowConfig as bQ, type KeyedWorkflowConfig as bR, type KeyedWorkflowStageConfig as bS, type KeyedWorkflowStageDefinition as bT, type KeyedWorkflowStages as bU, defineView as bV, type ViewScopeConfig as bW, type ContentTypeScopeConfig as bX, type ContentTypesScopeConfig as bY, type EntryTypeScopeConfig as bZ, type AllScopeConfig as b_, type ImageSourceConfig as ba, type ImageExifConfig as bb, type VariantDefinition as bc, type VideoUploadConfig as bd, type VideoPosterConfig as be, type VideoCaptionsConfig as bf, type VideoDownloadConfig as bg, type VideoWatermarkConfig as bh, type FileUploadConfig as bi, type FileScanConfig as bj, defineRole as bk, isRoleDefinition as bl, isBuiltInRole as bm, getBuiltInRoleActions as bn, BUILT_IN_ROLES as bo, ROLE_ACTIONS as bp, BUILT_IN_ROLE_ACTIONS as bq, type BuiltInRole as br, type RoleAction as bs, type ResourcePermission as bt, type FieldVisibility as bu, type RoleConfig as bv, type RoleDefinition as bw, type KeyedRoleConfig as bx, type KeyedRoleDefinition as by, type KeyedRoles as bz, type AssetAIConfig as c, type paths as c$, type ViewFilterValue as c0, type ViewFilterRelativeDate as c1, type ViewFilterCondition as c2, type ViewFilter as c3, type ViewConfig as c4, type ViewDefinition as c5, type KeyedViewConfig as c6, type KeyedViewDefinition as c7, type KeyedViews as c8, type KeyedViewsAsList as c9, type CreateInput as cA, type RevisedContent as cB, type RestoredContent as cC, type UpdateInput as cD, type SingletonContent as cE, type CustomQuery as cF, type ContentTypeSchema as cG, type FieldTypeName as cH, type ValidationRule as cI, type FieldOptions as cJ, type RealtimeEventType as cK, type RealtimeEvent as cL, type SubscriptionOptions as cM, type PerformanceMetrics as cN, type CacheConfig as cO, type RealtimeConfig as cP, type DebugConfig as cQ, type RequestConfig as cR, type ApiResponse as cS, type RetryConfig as cT, type CacheStrategy as cU, type LogLevel as cV, type Environment as cW, type ValidationViolation as cX, BaseValidationError as cY, ValidationError as cZ, InvalidPayloadError as c_, type InferJsonSchema as ca, type JsonFieldValue as cb, type JsonSchema as cc, type JsonValue as cd, type CheckedLocales as ce, type CheckedRoles as cf, type CheckedWorkflow as cg, type CheckedSection as ch, type KeysDeclared as ci, type LocaleCodesOf as cj, type StagesDeclared as ck, SDKError as cl, type RelyIOConfig as cm, type RelyIOConfigUpdate as cn, type LiveWebSocket as co, type LiveWebSocketConstructor as cp, type AssetFileBlock as cq, type AssetUrls as cr, type BaseContent as cs, type BaseSingleton as ct, type BaseSettingsGroup as cu, type WhereScalar as cv, type WhereFieldCondition as cw, type WhereClause as cx, type WhereOperator as cy, type DateOnlyOperator as cz, type BooleanConfig as d, type MergedRelyIOConfig as d0, type ReadWhere as d1, type CheckedInclude as d2, type components as d3, type FieldDefinition as d4, type DateTimeConfig as e, type DecimalConfig as f, type EnumConfig as g, type FieldDefinition$1 as h, type FieldRule as i, type FieldType as j, type FieldUIConfig as k, type KeyedField as l, type KeyedFieldOptions as m, type KeyedFields as n, type KeyedFieldsOf as o, type KeyedMembers as p, type KeyedMembersOf as q, type LocalizationConfig as r, type Localized as s, type LocalizedDetails as t, type LongTextConfig as u, type ReferenceConfig as v, type RequirementRule as w, type RichTextConfig as x, type RichTextLinks as y, type RuleCondition as z };
+export { enumField as $, type AIConfig as A, type BaseFieldConfig as B, type CodeConfig as C, type DateConfig as D, type EmailConfig as E, type FieldAIConfig as F, type RuleConditions as G, type SlugConfig as H, type IntegerConfig as I, type JsonConfig as J, type KeyedEnumConfig as K, type ListConfig as L, type TagsConfig as M, type VisibilityRule as N, type ObjectConfig as O, boolean as P, code as Q, type ReadOnlyRule as R, type ShortTextConfig as S, type TableConfig as T, type UrlConfig as U, type ValidationRule$1 as V, type WidgetOptions as W, date as X, dateTime as Y, decimal as Z, email as _, type AnyFieldDefinition as a, type AssetTypeDefinition as a$, integer as a0, json as a1, list as a2, longText as a3, object as a4, reference as a5, richText as a6, shortText as a7, slug as a8, table as a9, type TextDirection as aA, type LocaleOptions as aB, type LocaleDefinition as aC, defineContentType as aD, fieldset as aE, type Fieldset as aF, type DeclaredFieldset as aG, type AnyDeclaredFieldset as aH, type KeyedFieldsetConfig as aI, type FieldMember as aJ, type KeyedContentTypeConfig as aK, type ContentTypeDefinition as aL, type EntryMetadata as aM, type InferContentType as aN, type LocalePublicationFields as aO, defineSingleton as aP, type KeyedSingletonConfig as aQ, type SingletonContentTypeDefinition as aR, type SingletonMetadata as aS, type InferSingleton as aT, defineSettingsGroup as aU, type KeyedSettingsGroupConfig as aV, type SettingsGroupDefinition as aW, type SettingsGroupMetadata as aX, type InferSettingsGroup as aY, defineAssetType as aZ, type KeyedAssetTypeConfig as a_, tags as aa, url as ab, type FieldSchemaContext as ac, type FieldValue as ad, type FieldValues as ae, type DeclaredFields as af, type UnresolvedEntry as ag, type Keyed as ah, type BlockOf as ai, type ShapeValue as aj, type AssetReading as ak, type CheckedIncludes as al, type CheckInclude as am, type ContentReading as an, type IncludablePaths as ao, type Reading as ap, type ReadWith as aq, type SettingsReading as ar, type SingletonReading as as, type UntypedReading as at, defineLocale as au, isLocaleDefinition as av, getLocaleCodes as aw, findDefaultLocale as ax, getActiveLocales as ay, buildFallbackChain as az, type AnyKeyedField as b, type ViewFilterOperator as b$, type InferAssetType as b0, type InferAssetEntry as b1, type AssetServedBlocks as b2, type ImageKindConfig as b3, type VideoKindConfig as b4, type FileKindConfig as b5, type ImageTransform as b6, type ImageFitMode as b7, type ImageOutputFormat as b8, type ImageUploadConfig as b9, type KeyedRolesAsList as bA, defineWorkflow as bB, defineWorkflowStage as bC, defineContentTypeWorkflow as bD, isWorkflowDefinition as bE, isWorkflowStageDefinition as bF, getWorkflowStageIds as bG, findWorkflowStage as bH, getNextWorkflowStage as bI, getFirstWorkflowStage as bJ, isFinalWorkflowStage as bK, type WorkflowEscalation as bL, type WorkflowAutoAssign as bM, type WorkflowStageConfig as bN, type WorkflowStageDefinition as bO, type WorkflowDefinition as bP, type ContentTypeWorkflowConfig as bQ, type KeyedWorkflowConfig as bR, type KeyedWorkflowStageConfig as bS, type KeyedWorkflowStageDefinition as bT, type KeyedWorkflowStages as bU, defineView as bV, type ViewScopeConfig as bW, type ContentTypeScopeConfig as bX, type ContentTypesScopeConfig as bY, type EntryTypeScopeConfig as bZ, type AllScopeConfig as b_, type ImageSourceConfig as ba, type ImageExifConfig as bb, type VariantDefinition as bc, type VideoUploadConfig as bd, type VideoPosterConfig as be, type VideoCaptionsConfig as bf, type VideoDownloadConfig as bg, type VideoWatermarkConfig as bh, type FileUploadConfig as bi, type FileScanConfig as bj, defineRole as bk, isRoleDefinition as bl, isBuiltInRole as bm, getBuiltInRoleActions as bn, BUILT_IN_ROLES as bo, ROLE_ACTIONS as bp, BUILT_IN_ROLE_ACTIONS as bq, type BuiltInRole as br, type RoleAction as bs, type ResourcePermission as bt, type FieldVisibility as bu, type RoleConfig as bv, type RoleDefinition as bw, type KeyedRoleConfig as bx, type KeyedRoleDefinition as by, type KeyedRoles as bz, type AssetAIConfig as c, type paths as c$, type ViewFilterValue as c0, type ViewFilterRelativeDate as c1, type ViewFilterCondition as c2, type ViewFilter as c3, type ViewConfig as c4, type ViewDefinition as c5, type KeyedViewConfig as c6, type KeyedViewDefinition as c7, type KeyedViews as c8, type KeyedViewsAsList as c9, type CreateInput as cA, type RevisedContent as cB, type RestoredContent as cC, type ContentVersion as cD, type ContentVersionRow as cE, type UpdateInput as cF, type SingletonContent as cG, type CustomQuery as cH, type ContentTypeSchema as cI, type ValidationRule as cJ, type FieldOptions as cK, type RealtimeEventType as cL, type RealtimeEvent as cM, type SubscriptionOptions as cN, type PerformanceMetrics as cO, type CacheConfig as cP, type DebugConfig as cQ, type RequestConfig as cR, type ApiResponse as cS, type RetryConfig as cT, type CacheStrategy as cU, type LogLevel as cV, type Environment as cW, type ValidationViolation as cX, BaseValidationError as cY, ValidationError as cZ, InvalidPayloadError as c_, type InferJsonSchema as ca, type JsonFieldValue as cb, type JsonSchema as cc, type JsonValue as cd, type CheckedLocales as ce, type CheckedRoles as cf, type CheckedWorkflow as cg, type CheckedSection as ch, type KeysDeclared as ci, type LocaleCodesOf as cj, type StagesDeclared as ck, SDKError as cl, type RelyIOConfig as cm, type RelyIOConfigUpdate as cn, type LiveWebSocket as co, type LiveWebSocketConstructor as cp, type AssetFileBlock as cq, type AssetUrls as cr, type BaseContent as cs, type BaseSingleton as ct, type BaseSettingsGroup as cu, type WhereScalar as cv, type WhereFieldCondition as cw, type WhereClause as cx, type WhereOperator as cy, type DateOnlyOperator as cz, type BooleanConfig as d, type MergedRelyIOConfig as d0, type ReadWhere as d1, type components as d2, type CheckedInclude as d3, type FieldDefinition as d4, type DateTimeConfig as e, type DecimalConfig as f, type EnumConfig as g, type FieldDefinition$1 as h, type FieldRule as i, type FieldType as j, type FieldUIConfig as k, type KeyedField as l, type KeyedFieldOptions as m, type KeyedFields as n, type KeyedFieldsOf as o, type KeyedMembers as p, type KeyedMembersOf as q, type LocalizationConfig as r, type Localized as s, type LocalizedDetails as t, type LongTextConfig as u, type ReferenceConfig as v, type RequirementRule as w, type RichTextConfig as x, type RichTextLinks as y, type RuleCondition as z };