@relyio/sdk 0.11.0 → 0.13.0

package/dist/{index-BKEAYvvz.d.ts → index-CPjJ25R4.d.ts}

@@ -1,6 +1,5 @@
-import { K as MergedRelyIOConfig, A as ApiPath, c as ApiMethod, N as PathParamsOf, w as ApiResponse, W as Wire, v as RequestConfig, B as BaseContent, h as WhereClause, Q as QueryOptions, j as SortOptions, k as ContentQueryResult, C as CreateInput, U as UpdateInput, S as SDKError, H as BaseValidationError, G as ValidationViolation, R as RelyIOConfig, a as RelyIOConfigUpdate } from './index-C73cK2Tt.js';
-import { aK as components, aJ as paths, W as InferContentType, aa as InferAssetType, a3 as InferSingleton } from './define-content-type-ENAod5Ve.js';
-import { a as SchemaDefinition, b as SchemaContentTypeNames, j as SchemaEntryOf, ax as FilterOperator, h as SchemaAssetTypeNames, c as SchemaSingletonNames, g as SchemaSettingsGroupNames, I as InferSettingsGroup, e as SchemaQueryNames, f as SchemaLocaleCodes } from './define-schema-CVi8nwc7.js';
+import { cj as MergedRelyIOConfig, bC as ApiPath, bD as ApiMethod, ck as PathParamsOf, ca as ApiResponse, bF as Wire, c9 as RequestConfig, bL as BaseContent, ae as Reading, ai as UntypedReading, cl as ReadWhere, bO as WhereClause, bS as QueryOptions, aa as CheckedIncludes, af as ReadWith, bR as SortOptions, bX as ContentQueryResult, bT as CreateInput, bW as UpdateInput, bU as RevisedContent, bV as RestoredContent, bx as SDKError, cg as BaseValidationError, cf as ValidationViolation, aJ as AssetServedBlocks, cm as CheckedInclude, cn as components, bJ as AssetFileBlock, co as paths, by as RelyIOConfig, aq as InferContentType, ac as ContentReading, aH as InferAssetType, a9 as AssetReading, ay as InferSingleton, ah as SingletonReading, aD as InferSettingsGroup, ag as SettingsReading, bz as RelyIOConfigUpdate } from './include-paths-Cb7iPCW2.js';
+import { a as SchemaDefinition, b as SchemaContentTypeNames, j as SchemaEntryOf, a8 as FilterOperator, h as SchemaAssetTypeNames, c as SchemaSingletonNames, g as SchemaSettingsGroupNames, e as SchemaQueryNames, f as SchemaLocaleCodes } from './define-schema-UHViXKiv.js';
 import { VisitorResyncReason } from './live-visitor.js';
 import { DevUnreadableReason } from './dev-handshake/index.js';
 
@@ -288,7 +287,7 @@ type ExtendedQueryResult<T extends BaseContent = BaseContent> = ContentQueryResu
  *   .execute()
  * ```
  */
-declare class ContentQueryBuilder<T extends BaseContent = BaseContent, F extends BaseContent = T> {
+declare class ContentQueryBuilder<T extends BaseContent = BaseContent, F extends BaseContent = T, R extends Reading = UntypedReading<T>, I extends string = never> {
     private readonly httpClient;
     private readonly contentType;
     private queryOptions;
@@ -323,18 +322,27 @@ declare class ContentQueryBuilder<T extends BaseContent = BaseContent, F extends
      */
     headers(headers: Record<string, string>): this;
     /**
-     * Add where conditions to the query: conditions on the fields the content type declares. A
-     * condition on `_metadata` is refused here, before anything is sent (`refuseMetadataConditions`).
+     * Add where conditions to the query, each naming a value by its path: a field the content type
+     * declares, a field inside an object (`'pricing.basePrice'`), a reference inside its blocks —
+     * `{ 'sections.features': featureId }` keeps the entries some block of which holds that feature
+     * (REL-1810) — and rich text that can point at an entry, by the entries it points at. A typed read
+     * takes exactly the paths the API filters by (`FilterPaths`, REL-2136). A condition on `_metadata`
+     * is refused here, before anything is sent (`refuseMetadataConditions`).
      */
-    where(conditions: WhereClause<F>): this;
+    where(conditions: ReadWhere<WhereClause<F>, R>): this;
     /**
      * Select specific fields to return
      */
     select(fields: NonNullable<QueryOptions<T, F>['select']>): this;
     /**
-     * Include related content in the response
+     * Expand references into the entries they point at: one include path per element (REL-1801).
+     * A path names fields through lists, page builders, objects and references —
+     * `'sections.features'`, `'sections.customers.logo'` — and may pick the fields each entry returns,
+     * `'sections.features(name,slug)'`. Each is checked against the schema: a path that holds no
+     * reference does not compile, and the read's type follows the paths — an expanded reference is the
+     * entry, every other one its id.
      */
-    include(relations: string[]): this;
+    include<const P extends readonly string[]>(paths: CheckedIncludes<R, P>): ContentQueryBuilder<Extract<ReadWith<R, I | P[number]>, BaseContent>, F, R, I | P[number]>;
     /**
      * Add sorting to the query
      *
@@ -477,7 +485,7 @@ declare class ContentQueryBuilder<T extends BaseContent = BaseContent, F extends
     /**
      * Clone the query builder
      */
-    clone(): ContentQueryBuilder<T, F>;
+    clone(): ContentQueryBuilder<T, F, R, I>;
     /**
      * Get the current query options
      */
@@ -514,7 +522,7 @@ declare class ContentQueryBuilder<T extends BaseContent = BaseContent, F extends
 /**
  * Specialized query builder for finding by ID
  */
-declare class ContentByIdBuilder<T extends BaseContent = BaseContent> {
+declare class ContentByIdBuilder<T extends BaseContent = BaseContent, R extends Reading = UntypedReading<T>, I extends string = never> {
     private readonly httpClient;
     private readonly contentType;
     private readonly id;
@@ -541,9 +549,14 @@ declare class ContentByIdBuilder<T extends BaseContent = BaseContent> {
      */
     fresh(position: string): this;
     /**
-     * Include related content in the response
+     * Expand references into the entries they point at: one include path per element (REL-1801).
+     * A path names fields through lists, page builders, objects and references —
+     * `'sections.features'`, `'sections.customers.logo'` — and may pick the fields each entry returns,
+     * `'sections.features(name,slug)'`. Each is checked against the schema: a path that holds no
+     * reference does not compile, and the read's type follows the paths — an expanded reference is the
+     * entry, every other one its id. A second call adds to the first.
      */
-    include(relations: string[]): this;
+    include<const P extends readonly string[]>(paths: CheckedIncludes<R, P>): ContentByIdBuilder<Extract<ReadWith<R, I | P[number]>, BaseContent>, R, I | P[number]>;
     /**
      * Set locale for localized content
      * @param locale - Locale code (e.g., 'en-US', 'de-DE', 'fr-FR')
@@ -647,17 +660,20 @@ declare function entityTagOf(response: {
 /**
  * Content fetch options
  */
-interface ContentFetchOptions<T extends BaseContent = BaseContent> {
-    /** Filter conditions */
-    where?: WhereClause<T>;
+interface ContentFetchOptions<T extends BaseContent = BaseContent, R extends Reading = UntypedReading<T>> {
+    /** Filter conditions: what `query().where()` takes (REL-2136) */
+    where?: ReadWhere<WhereClause<T>, R>;
     /** Maximum entries to return */
     limit?: number;
     /** Entries to skip (offset pagination) */
     offset?: number;
     /** Sort configuration */
     sort?: Record<string, 'asc' | 'desc'>;
-    /** Reference fields to populate */
-    include?: string[];
+    /**
+     * Include paths: the references to expand (REL-1801) — see `ContentQueryBuilder.include`. Typed
+     * where `fetch` is called with them inline.
+     */
+    include?: readonly string[];
     /** Locale for localized content */
     locale?: string;
     /** Fields to select (projection) */
@@ -685,7 +701,7 @@ interface ContentFetchOptions<T extends BaseContent = BaseContent> {
  * const all = await products.fetchAll()
  * ```
  */
-declare class ContentClient<T extends BaseContent = BaseContent> {
+declare class ContentClient<T extends BaseContent = BaseContent, R extends Reading = UntypedReading<T>> {
     private readonly httpClient;
     private readonly contentType;
     /** The client's locale, asked on every call rather than copied when this client was taken. */
@@ -698,11 +714,11 @@ declare class ContentClient<T extends BaseContent = BaseContent> {
     /**
      * Create a new query builder for this content type
      */
-    query(): ContentQueryBuilder<T>;
+    query(): ContentQueryBuilder<T, T, R>;
     /**
      * Find content by ID with fluent options
      */
-    findById(id: string): ContentByIdBuilder<T>;
+    findById(id: string): ContentByIdBuilder<T, R>;
     /**
      * Fetch all content items
      * @param locale - Optional locale for localized content
@@ -711,15 +727,22 @@ declare class ContentClient<T extends BaseContent = BaseContent> {
     /**
      * Fetch content with query options
      */
-    fetch(options?: ContentFetchOptions<T>): Promise<T[]>;
+    fetch<const P extends readonly string[]>(options: Omit<ContentFetchOptions<T, R>, 'include'> & {
+        include: CheckedIncludes<R, P>;
+    }): Promise<Array<ReadWith<R, P[number]>>>;
+    fetch(options?: Omit<ContentFetchOptions<T, R>, 'include'>): Promise<T[]>;
     /**
      * Fetch a single content item by ID
      * @param id - Entry ID or slug
      * @param options - Fetch options (include, locale, and `headers` this one request adds — e.g.
      *   `{ 'X-RelyIO-Dataset': 'staging' }` to read a dataset other than the client's)
      */
+    fetchOne<const P extends readonly string[]>(id: string, options: {
+        include: CheckedIncludes<R, P>;
+        locale?: string;
+        headers?: Record<string, string>;
+    }): Promise<ReadWith<R, P[number]> | null>;
     fetchOne(id: string, options?: {
-        include?: string[];
         locale?: string;
         headers?: Record<string, string>;
     }): Promise<T | null>;
@@ -741,8 +764,15 @@ declare class ContentClient<T extends BaseContent = BaseContent> {
      * whether the entry, the content type or the schema was missing. `headers`
      * are the ones this read adds, as for `fetchOne`.
      */
+    fetchOneWithTag<const P extends readonly string[]>(id: string, options: {
+        include: CheckedIncludes<R, P>;
+        locale?: string;
+        headers?: Record<string, string>;
+    }): Promise<{
+        entry: ReadWith<R, P[number]>;
+        entityTag?: string;
+    }>;
     fetchOneWithTag(id: string, options?: {
-        include?: string[];
         locale?: string;
         headers?: Record<string, string>;
     }): Promise<{
@@ -754,7 +784,7 @@ declare class ContentClient<T extends BaseContent = BaseContent> {
      * @param where - Filter conditions
      * @param locale - Optional locale
      */
-    fetchFirst(where?: WhereClause<T>, locale?: string): Promise<T | null>;
+    fetchFirst(where?: ReadWhere<WhereClause<T>, R>, locale?: string): Promise<T | null>;
     /**
      * Create a new content item
      * @param data - Content data
@@ -778,6 +808,8 @@ declare class ContentClient<T extends BaseContent = BaseContent> {
      *   request adds, as for {@link create}. `ifMatch` and `idempotencyKey` win over the same
      *   header among them. `locale` defaults to the client's own, the locale whose entity tag
      *   {@link fetchOneWithTag} reads, so the tag it hands back is checked against the same locale.
+     * @returns The entry, its `_metadata.brokenLinks` naming each entry link another entry publishes
+     *   that this revision left pointing nowhere — empty when it took no heading away.
      */
     update(id: string, data: UpdateInput<T>, options?: {
         slug?: string;
@@ -785,7 +817,7 @@ declare class ContentClient<T extends BaseContent = BaseContent> {
         parentId?: string;
         sortOrder?: number;
         headers?: Record<string, string>;
-    } & ConditionalWriteOptions): Promise<T>;
+    } & ConditionalWriteOptions): Promise<RevisedContent<T>>;
     /**
      * Delete a content item by ID
      */
@@ -829,15 +861,19 @@ declare class ContentClient<T extends BaseContent = BaseContent> {
      * The restore is validated as strictly as a publish, so it cannot publish invalid content, and it
      * records a new version of its own rather than rewinding the counter — so the revert is auditable
      * and itself reversible.
+     *
+     * @returns The entry, its `_metadata.leftOut` naming each value of the version the active schema
+     *   no longer declares, and `_metadata.brokenLinks` the entry links it left pointing nowhere.
      */
-    restore(id: string, versionNumber: number, locale: string, options?: ConditionalWriteOptions): Promise<T>;
+    restore(id: string, versionNumber: number, locale: string, options?: ConditionalWriteOptions): Promise<RestoredContent<T>>;
     /**
-     * Get children of a hierarchical entry
+     * Get the direct children of a hierarchical entry. The route lists one level and takes no depth
+     * (REL-2195): `{ depth }` was sent as `?depth=`, which the API refused with `400`. A tree nested
+     * under each entry is a list or entry read's `query().children()`.
      * @param id - Parent entry ID
-     * @param options - Fetch options
+     * @param options - Include paths to expand on each child, and the locale to read
      */
     children(id: string, options?: {
-        depth?: number;
         include?: string[];
         locale?: string;
     }): Promise<T[]>;
@@ -853,7 +889,7 @@ declare class ContentClient<T extends BaseContent = BaseContent> {
      * Create a new ContentClient with a different default locale, fixed: an update of the client's
      * locale (`updateConfig({ locale })`) does not reach it
      */
-    withLocale(locale: string): ContentClient<T>;
+    withLocale(locale: string): ContentClient<T, R>;
     /**
      * Get the default locale as it is now: the client's, or the one `withLocale()` fixed
      */
@@ -937,12 +973,6 @@ type AssetVisibility = 'public' | 'protected' | 'private';
 type FileStatus = 'pending_upload' | 'uploading' | 'processing' | 'ready' | 'failed';
 /** Storage backend: `r2` = image + file kinds, `stream` = video kind. */
 type FileBackend = 'r2' | 'stream';
-/**
- * Customer-facing file binding block on an asset entry: the document's `AssetFile` — status,
- * backend, file name, MIME type, size, advisory hash, visibility, extracted metadata, focal point,
- * enrichment and scan status, processing stage/progress/error, and video playback readiness.
- */
-type AssetFileBlock = components['schemas']['AssetFile'];
 /** Extracted media metadata (Phase 1 basics + Phase 2 enrichment, plans 15–19); open-ended. */
 type AssetFileExtracted = NonNullable<AssetFileBlock['extracted']>;
 /**
@@ -951,33 +981,13 @@ type AssetFileExtracted = NonNullable<AssetFileBlock['extracted']>;
  * nothing of the entry's content. `processing.error` is present exactly while `status` is `failed`.
  */
 type FileStatusResult = components['schemas']['FileStatus'];
-/**
- * Computed gateway delivery URLs (the reserved `urls` key). Always served from
- * `cdn.relyio.net`. Image bindings expose `original` + `variants`; video bindings
- * expose `playback`/`poster`/`download`. Present only when `file.status` is
- * `ready` — otherwise the response omits `urls` and callers read `file.status`.
- */
-interface AssetUrls {
-    /** Image: canonical original delivery URL. */
-    original?: string;
-    /** Image: variant id → delivery URL map. */
-    variants?: Record<string, string>;
-    /** Video: HLS/DASH manifest URL. */
-    playback?: string;
-    /** Video: poster image URL. */
-    poster?: string;
-    /** Video: downloadable MP4 URL (when enabled). */
-    download?: string;
-    [key: string]: unknown;
-}
+
 /**
  * An asset entry response: schema fields at the top level plus the reserved
- * `file` + `urls` blocks and `_metadata`. `T` carries the inferred field shape.
+ * `file` + `urls` blocks and `_metadata`. `T` carries the inferred field shape — for a typed client
+ * `InferAssetType`, so this is `InferAssetEntry`, the shape an expanded asset reads as too.
  */
-type AssetEntryResponse<T extends BaseContent = BaseContent> = T & {
-    file?: AssetFileBlock;
-    urls?: AssetUrls;
-};
+type AssetEntryResponse<T extends BaseContent = BaseContent> = T & AssetServedBlocks;
 /** Request a single upload target for the binding. */
 interface PresignInput {
     /** Original file name (required). */
@@ -1292,7 +1302,20 @@ declare class AssetUploadBuilder<T extends BaseContent = BaseContent> {
  * over the same dynamic `/{assetType}` routes — assets are `entryType: 'asset'`
  * entries) and adds the `file(uid)` sub-resource builder + an `upload()` helper.
  */
-declare class AssetClient<T extends BaseContent = BaseContent> {
+/**
+ * An asset read typed by the asset type's reading `R`: what the type's include paths make of its
+ * fields, beside the `file` and `urls` blocks every asset read carries (REL-1801).
+ */
+interface AssetResponseReading<R extends Reading, T extends BaseContent = BaseContent> extends Reading {
+    readonly read: AssetEntryResponse<Extract<ReadWith<R, this['include']>, BaseContent>>;
+    readonly checked: CheckedInclude<R, this['path']>;
+    /**
+     * The asset type's own `where` — every path the API filters its fields by, never the `file` and
+     * `urls` blocks — or, where no schema types it, the conditions `T`'s keys take (REL-2195).
+     */
+    readonly where: ReadWhere<WhereClause<T>, R>;
+}
+declare class AssetClient<T extends BaseContent = BaseContent, R extends Reading = UntypedReading<T>> {
     private readonly httpClient;
     private readonly assetType;
     /** The client's locale, asked on every call rather than copied when this client was taken. */
@@ -1306,16 +1329,19 @@ declare class AssetClient<T extends BaseContent = BaseContent> {
      * Create a query builder for this asset type. It resolves asset reads; its conditions name the
      * asset type's fields, which the `file` and `urls` blocks are not.
      */
-    query(): ContentQueryBuilder<AssetEntryResponse<T>, T>;
+    query(): ContentQueryBuilder<AssetEntryResponse<T>, T, AssetResponseReading<R, T>>;
     /** Find an asset entry by id (or slug) with fluent options. */
-    findById(id: string): ContentByIdBuilder<AssetEntryResponse<T>>;
+    findById(id: string): ContentByIdBuilder<AssetEntryResponse<T>, AssetResponseReading<R, T>>;
     /** Fetch a single asset entry by id (or slug), or `null` if not found. */
+    fetchOne<const P extends readonly string[]>(id: string, options: {
+        include: CheckedIncludes<R, P>;
+        locale?: string;
+    }): Promise<ReadWith<AssetResponseReading<R, T>, P[number]> | null>;
     fetchOne(id: string, options?: {
-        include?: string[];
         locale?: string;
     }): Promise<AssetEntryResponse<T> | null>;
     /** Fetch the first asset entry matching the conditions, or `null`. */
-    fetchFirst(where?: WhereClause<T>, locale?: string): Promise<AssetEntryResponse<T> | null>;
+    fetchFirst(where?: ReadWhere<WhereClause<T>, R>, locale?: string): Promise<AssetEntryResponse<T> | null>;
     /**
      * Create a new asset entry as a draft. The binary is uploaded separately via
      * `file(uid)` (or use the high-level `upload()` helper), and the entry
@@ -1369,8 +1395,11 @@ type PopulatedAssetReference<T extends BaseContent = BaseContent> = AssetEntryRe
 interface SingletonFetchOptions {
     /** Locale for localized content */
     locale?: string;
-    /** Reference fields to populate */
-    include?: string[];
+    /**
+     * Include paths: the references to expand (REL-1801), added to the ones `include()` named — see
+     * `include()`. Typed where the call names them inline.
+     */
+    include?: readonly string[];
     /**
      * The feed position this read follows — a change's `fresh` (`FeedChange`), or a resync's. Sent as
      * `?_fresh`: no cache holds an answer for it from before that position, so the read is answered
@@ -1395,7 +1424,7 @@ interface SingletonFetchOptions {
  *   .fetch()
  * ```
  */
-declare class SingletonClient<T = unknown> {
+declare class SingletonClient<T = unknown, R extends Reading = UntypedReading<T>, I extends string = never> {
     private httpClient;
     private singletonKey;
     private includeFields?;
@@ -1408,10 +1437,14 @@ declare class SingletonClient<T = unknown> {
      */
     constructor(httpClient: HttpClient, singletonKey: string, locale?: ClientLocale);
     /**
-     * Include reference fields in the response
-     * @param fields - Reference field names to populate
+     * Expand references into the entries they point at: one include path per element (REL-1801).
+     * A path names fields through lists, objects and references — `'hero.media.image'`,
+     * `'featured.author'` — and may pick the fields each entry returns, `'featured(title,slug)'`.
+     * Each is checked against the schema: a path that holds no reference does not compile, and the
+     * read's type follows the paths — an expanded reference is the entry, every other one its id. A
+     * second call adds to the first.
      */
-    include(fields: string[]): this;
+    include<const P extends readonly string[]>(paths: CheckedIncludes<R, P>): SingletonClient<ReadWith<R, I | P[number]>, R, I | P[number]>;
     /**
      * Set locale for localized content
      * @param locale - Locale code (e.g., 'en', 'de', 'fr')
@@ -1421,7 +1454,10 @@ declare class SingletonClient<T = unknown> {
      * Fetch the singleton content
      * @param options - Optional fetch options (alternative to fluent methods)
      */
-    fetch(options?: SingletonFetchOptions): Promise<T | null>;
+    fetch<const P extends readonly string[]>(options: Omit<SingletonFetchOptions, 'include'> & {
+        include: CheckedIncludes<R, P>;
+    }): Promise<ReadWith<R, I | P[number]> | null>;
+    fetch(options?: Omit<SingletonFetchOptions, 'include'>): Promise<T | null>;
     /**
      * Fetch the singleton **and the entity tag that read served**, which is what
      * `update`'s `ifMatch` takes (`INV-API-CONDITIONAL-WRITE-IS-REACHABLE`).
@@ -1479,7 +1515,7 @@ declare class SingletonClient<T = unknown> {
     /**
      * Reset fluent options for reuse
      */
-    reset(): this;
+    reset(): SingletonClient<ReadWith<R, never>, R>;
 }
 
 /**
@@ -1488,8 +1524,11 @@ declare class SingletonClient<T = unknown> {
 interface SettingsFetchOptions {
     /** Locale for localized settings */
     locale?: string;
-    /** Reference fields to populate */
-    include?: string[];
+    /**
+     * Include paths: the references to expand (REL-1801), added to the ones `include()` named — see
+     * `include()`. Typed where the call names them inline.
+     */
+    include?: readonly string[];
 }
 /**
  * Settings client for managing settings group operations
@@ -1508,7 +1547,7 @@ interface SettingsFetchOptions {
  *   .fetch()
  * ```
  */
-declare class SettingsClient<T = unknown> {
+declare class SettingsClient<T = unknown, R extends Reading = UntypedReading<T>, I extends string = never> {
     private readonly httpClient;
     private readonly groupId;
     private includeFields?;
@@ -1521,10 +1560,14 @@ declare class SettingsClient<T = unknown> {
      */
     constructor(httpClient: HttpClient, groupId: string, locale?: ClientLocale);
     /**
-     * Include reference fields in the response
-     * @param fields - Reference field names to populate
+     * Expand references into the entries they point at: one include path per element (REL-1801).
+     * A path names fields through lists, objects and references — `'hero.media.image'`,
+     * `'featured.author'` — and may pick the fields each entry returns, `'featured(title,slug)'`.
+     * Each is checked against the schema: a path that holds no reference does not compile, and the
+     * read's type follows the paths — an expanded reference is the entry, every other one its id. A
+     * second call adds to the first.
      */
-    include(fields: string[]): this;
+    include<const P extends readonly string[]>(paths: CheckedIncludes<R, P>): SettingsClient<ReadWith<R, I | P[number]>, R, I | P[number]>;
     /**
      * Set locale for localized settings
      * @param locale - Locale code (e.g., 'en', 'de', 'fr')
@@ -1534,7 +1577,10 @@ declare class SettingsClient<T = unknown> {
      * Fetch the settings group
      * @param options - Optional fetch options (alternative to fluent methods)
      */
-    fetch(options?: SettingsFetchOptions): Promise<T | null>;
+    fetch<const P extends readonly string[]>(options: Omit<SettingsFetchOptions, 'include'> & {
+        include: CheckedIncludes<R, P>;
+    }): Promise<ReadWith<R, I | P[number]> | null>;
+    fetch(options?: Omit<SettingsFetchOptions, 'include'>): Promise<T | null>;
     /**
      * Update settings group
      *
@@ -1605,12 +1651,12 @@ declare class SettingsClient<T = unknown> {
     /**
      * Reset fluent options for reuse
      */
-    resetOptions(): this;
+    resetOptions(): SettingsClient<ReadWith<R, never>, R>;
 }
 
 /**
  * Any schema the client can be typed by. `any` is deliberate: the client accepts whatever content
- * types, components, singletons, queries and settings groups a customer declares.
+ * types, singletons, queries and settings groups a customer declares.
  *
  * This is the constraint `TypedRelyIOClient`'s `TSchema` carries, so `RegisteredSchema` is inferred
  * against the same one — `createClient` returns `TypedRelyIOClient<RegisteredSchema>`, and a schema
@@ -1666,9 +1712,12 @@ type SearchHitSystemFields = Pick<components['schemas']['SearchHit'], '_metadata
  * `_metadata`, and the score annotations the request asked for. There is no per-item `data` wrapper.
  *
  * `T`'s `_metadata` is replaced, not kept: `T` is an entry type, and a hit is not an entry read.
- * Distributes over a union of entry types, so a search across two types keeps each one's fields.
+ * Every field is optional, a required one too: a `fields` projection names only some of them, and a
+ * hit is built from the search row, not by the read that fills a required field a draft holds empty
+ * (REL-1795). Distributes over a union of entry types, so a search across two types keeps each
+ * one's fields.
  */
-type SearchResultItem<T = unknown> = T extends unknown ? Omit<T, '_metadata'> & SearchHitSystemFields : never;
+type SearchResultItem<T = unknown> = T extends unknown ? Partial<Omit<T, '_metadata'>> & SearchHitSystemFields : never;
 /**
  * Search response from API
  */
@@ -3203,7 +3252,7 @@ declare class TypedRelyIOClient<TSchema extends AnySchemaDefinition | undefined
      *   .execute()
      * ```
      */
-    content<K extends TSchema extends AnySchemaDefinition ? SchemaContentTypeNames<TSchema> : string>(contentType: K): TSchema extends AnySchemaDefinition ? ContentClient<InferContentType<TSchema['contentTypes'][K & keyof TSchema['contentTypes']], TSchema>> : ContentClient<BaseContent>;
+    content<K extends TSchema extends AnySchemaDefinition ? SchemaContentTypeNames<TSchema> : string>(contentType: K): TSchema extends AnySchemaDefinition ? ContentClient<InferContentType<TSchema['contentTypes'][K & keyof TSchema['contentTypes']], TSchema>, ContentReading<TSchema['contentTypes'][K & keyof TSchema['contentTypes']], TSchema>> : ContentClient<BaseContent>;
     /**
      * Get an asset client for a specific asset type.
      *
@@ -3222,7 +3271,7 @@ declare class TypedRelyIOClient<TSchema extends AnySchemaDefinition | undefined
      * const heroUrl = await relyio.asset('productPhoto').file(photo._metadata.id).url({ variantId: 'hero' })
      * ```
      */
-    asset<K extends TSchema extends AnySchemaDefinition ? SchemaAssetTypeNames<TSchema> : string>(assetType: K): TSchema extends AnySchemaDefinition ? AssetClient<InferAssetType<NonNullable<TSchema['assetTypes']>[K & keyof NonNullable<TSchema['assetTypes']>], TSchema>> : AssetClient<BaseContent>;
+    asset<K extends TSchema extends AnySchemaDefinition ? SchemaAssetTypeNames<TSchema> : string>(assetType: K): TSchema extends AnySchemaDefinition ? AssetClient<InferAssetType<NonNullable<TSchema['assetTypes']>[K & keyof NonNullable<TSchema['assetTypes']>], TSchema>, AssetReading<NonNullable<TSchema['assetTypes']>[K & keyof NonNullable<TSchema['assetTypes']>], TSchema>> : AssetClient<BaseContent>;
     /**
      * Get a singleton client for a specific singleton key
      * Type-safe when schema is provided: autocompletes singleton names AND field names
@@ -3235,7 +3284,7 @@ declare class TypedRelyIOClient<TSchema extends AnySchemaDefinition | undefined
      *   .fetch()
      * ```
      */
-    singleton<K extends TSchema extends AnySchemaDefinition ? SchemaSingletonNames<TSchema> : string>(key: K): TSchema extends AnySchemaDefinition ? SingletonClient<InferSingleton<TSchema['singletonContentTypes'][K & keyof TSchema['singletonContentTypes']], TSchema>> : SingletonClient<unknown>;
+    singleton<K extends TSchema extends AnySchemaDefinition ? SchemaSingletonNames<TSchema> : string>(key: K): TSchema extends AnySchemaDefinition ? SingletonClient<InferSingleton<TSchema['singletonContentTypes'][K & keyof TSchema['singletonContentTypes']], TSchema>, SingletonReading<TSchema['singletonContentTypes'][K & keyof TSchema['singletonContentTypes']], TSchema>> : SingletonClient<unknown>;
     /**
      * Get a settings client for a specific settings group
      * Type-safe when schema is provided: autocompletes settings group names AND field names
@@ -3247,7 +3296,7 @@ declare class TypedRelyIOClient<TSchema extends AnySchemaDefinition | undefined
      *   .fetch()
      * ```
      */
-    settings<K extends TSchema extends AnySchemaDefinition ? SchemaSettingsGroupNames<TSchema> : string>(groupId: K): TSchema extends AnySchemaDefinition ? SettingsClient<InferSettingsGroup<NonNullable<TSchema['settingsGroups']>[K & keyof NonNullable<TSchema['settingsGroups']>], TSchema>> : SettingsClient<unknown>;
+    settings<K extends TSchema extends AnySchemaDefinition ? SchemaSettingsGroupNames<TSchema> : string>(groupId: K): TSchema extends AnySchemaDefinition ? SettingsClient<InferSettingsGroup<NonNullable<TSchema['settingsGroups']>[K & keyof NonNullable<TSchema['settingsGroups']>], TSchema>, SettingsReading<NonNullable<TSchema['settingsGroups']>[K & keyof NonNullable<TSchema['settingsGroups']>], TSchema>> : SettingsClient<unknown>;
     /**
      * Start a search query with full-text, semantic, or hybrid search.
      *
@@ -3665,4 +3714,4 @@ declare function createClient<TSchema extends AnySchemaDefinition>(config: Typed
  */
 type ClientSchema<T extends TypedRelyIOClient<AnySchemaDefinition>> = T extends TypedRelyIOClient<infer TSchema> ? TSchema : never;
 
-export { type BatchOptions as $, type ActiveSandbox as A, type SearchMode as B, type Change as C, type SearchResultItem as D, type ExtendedQueryResult as E, type FeedChange as F, type SearchHitMetadata as G, HttpClient as H, type SearchResponse as I, type AutocompleteSuggestion as J, type AutocompleteResponse as K, LIVE_KEEPALIVE_INTERVAL_MS as L, type SimilarResult as M, type SimilarResponse as N, type SearchFilter as O, type Project as P, type SearchFields as Q, type Register as R, type SandboxState as S, TypedRelyIOClient as T, type SearchSort as U, type SearchTypeName as V, type SearchEntry as W, BatchClient as X, BatchBuilder as Y, type BatchMethod as Z, type BatchOperation as _, ChangesExpiredError as a, type BatchOperationResult as a0, type BatchSummary as a1, type BatchResponse as a2, AdhocQueryClient as a3, AdhocQueryBuilder as a4, type FetchBlock as a5, type AggregateBlock as a6, type AggregateMetric as a7, type SearchBlock as a8, type FilterValue as a9, type MultipartCreateResult as aA, type MultipartPart as aB, type MultipartTarget as aC, type UploadProgress as aD, ResourceNotFoundError as aE, ResourceConflictError as aF, ResourceExpiredError as aG, isResourceNotFound as aH, type FileErrorCode as aI, type FileUploadErrorCode as aJ, FileUploadError as aK, FileValidationError as aL, type FileValidationConstraints as aM, validateFile as aN, type FullTextConfig as aa, type AdhocQueryDefinition as ab, type AdhocQueryOptions as ac, type QueryMetadata as ad, type AdhocQueryResult as ae, AssetClient as af, AssetFileBuilder as ag, AssetUploadBuilder as ah, isAssetEntry as ai, type AssetVisibility as aj, type FileStatus as ak, type FileBackend as al, type AssetFileBlock as am, type AssetFileExtracted as an, type FileStatusResult as ao, type AssetUrls as ap, type AssetEntryResponse as aq, type PopulatedAssetReference as ar, type PresignInput as as, type PresignResult as at, type ConfirmInput as au, type ConfirmResult as av, type ResolveUrlInput as aw, type ResolveUrlResult as ax, type CreateAssetOptions as ay, type WaitUntilReadyOptions as az, type ChangesExpiredReason as b, createClient as c, type TypedClientConfig as d, type ClientSchema as e, type RegisteredSchema as f, type SendOptions as g, entityTagOf as h, type ConditionalWriteOptions as i, type RetryableWriteOptions as j, type ChangesHeadOptions as k, type ChangesOptions as l, LIVE_SOCKET_OPEN_TIMEOUT_MS as m, type LiveChangesOptions as n, ContentClient as o, SingletonClient as p, SettingsClient as q, ContentQueryBuilder as r, ContentByIdBuilder as s, type ChildrenOptions as t, type SingletonFetchOptions as u, type SettingsFetchOptions as v, SearchClient as w, SearchBuilder as x, AutocompleteBuilder as y, SimilarBuilder as z };
+export { type BatchOptions as $, type ActiveSandbox as A, type SearchMode as B, type Change as C, type SearchResultItem as D, type ExtendedQueryResult as E, type FeedChange as F, type SearchHitMetadata as G, HttpClient as H, type SearchResponse as I, type AutocompleteSuggestion as J, type AutocompleteResponse as K, LIVE_KEEPALIVE_INTERVAL_MS as L, type SimilarResult as M, type SimilarResponse as N, type SearchFilter as O, type Project as P, type SearchFields as Q, type Register as R, type SandboxState as S, TypedRelyIOClient as T, type SearchSort as U, type SearchTypeName as V, type SearchEntry as W, BatchClient as X, BatchBuilder as Y, type BatchMethod as Z, type BatchOperation as _, ChangesExpiredError as a, type BatchOperationResult as a0, type BatchSummary as a1, type BatchResponse as a2, AdhocQueryClient as a3, AdhocQueryBuilder as a4, type FetchBlock as a5, type AggregateBlock as a6, type AggregateMetric as a7, type SearchBlock as a8, type FilterValue as a9, type MultipartTarget as aA, type UploadProgress as aB, ResourceNotFoundError as aC, ResourceConflictError as aD, ResourceExpiredError as aE, isResourceNotFound as aF, type FileErrorCode as aG, type FileUploadErrorCode as aH, FileUploadError as aI, FileValidationError as aJ, type FileValidationConstraints as aK, validateFile as aL, type FullTextConfig as aa, type AdhocQueryDefinition as ab, type AdhocQueryOptions as ac, type QueryMetadata as ad, type AdhocQueryResult as ae, AssetClient as af, AssetFileBuilder as ag, AssetUploadBuilder as ah, isAssetEntry as ai, type AssetVisibility as aj, type FileStatus as ak, type FileBackend as al, type AssetFileExtracted as am, type FileStatusResult as an, type AssetEntryResponse as ao, type PopulatedAssetReference as ap, type PresignInput as aq, type PresignResult as ar, type ConfirmInput as as, type ConfirmResult as at, type ResolveUrlInput as au, type ResolveUrlResult as av, type CreateAssetOptions as aw, type WaitUntilReadyOptions as ax, type MultipartCreateResult as ay, type MultipartPart as az, type ChangesExpiredReason as b, createClient as c, type TypedClientConfig as d, type ClientSchema as e, type RegisteredSchema as f, type SendOptions as g, entityTagOf as h, type ConditionalWriteOptions as i, type RetryableWriteOptions as j, type ChangesHeadOptions as k, type ChangesOptions as l, LIVE_SOCKET_OPEN_TIMEOUT_MS as m, type LiveChangesOptions as n, ContentClient as o, SingletonClient as p, SettingsClient as q, ContentQueryBuilder as r, ContentByIdBuilder as s, type ChildrenOptions as t, type SingletonFetchOptions as u, type SettingsFetchOptions as v, SearchClient as w, SearchBuilder as x, AutocompleteBuilder as y, SimilarBuilder as z };