@relyio/sdk 0.12.0 → 0.13.0

package/dist/{index-BrvEg6-A.d.cts → index-BT0L8xJj.d.cts}

@@ -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-b-AkfTUv.cjs';
-import { W as Reading, _ as UntypedReading, M as CheckedIncludes, X as ReadWith, aX as components, aY as CheckedInclude, aW as paths, a6 as InferContentType, P as ContentReading, an as InferAssetType, J as AssetReading, ae as InferSingleton, Z as SingletonReading, aj as InferSettingsGroup, Y as SettingsReading } from './include-paths-CL4gHv6I.cjs';
-import { a as SchemaDefinition, b as SchemaContentTypeNames, j as SchemaEntryOf, al as FilterOperator, h as SchemaAssetTypeNames, c as SchemaSingletonNames, g as SchemaSettingsGroupNames, e as SchemaQueryNames, f as SchemaLocaleCodes } from './define-schema-DgctHlI2.cjs';
+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-Bs5FhNw2.cjs';
+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-sWJ8Zn7C.cjs';
 import { VisitorResyncReason } from './live-visitor.js';
 import { DevUnreadableReason } from './dev-handshake/index.cjs';
 
@@ -323,10 +322,14 @@ 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
      */
@@ -657,9 +660,9 @@ 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) */
@@ -724,10 +727,10 @@ declare class ContentClient<T extends BaseContent = BaseContent, R extends Readi
     /**
      * Fetch content with query options
      */
-    fetch<const P extends readonly string[]>(options: Omit<ContentFetchOptions<T>, 'include'> & {
+    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>, 'include'>): Promise<T[]>;
+    fetch(options?: Omit<ContentFetchOptions<T, R>, 'include'>): Promise<T[]>;
     /**
      * Fetch a single content item by ID
      * @param id - Entry ID or slug
@@ -781,7 +784,7 @@ declare class ContentClient<T extends BaseContent = BaseContent, R extends Readi
      * @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
@@ -805,6 +808,8 @@ declare class ContentClient<T extends BaseContent = BaseContent, R extends Readi
      *   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;
@@ -812,7 +817,7 @@ declare class ContentClient<T extends BaseContent = BaseContent, R extends Readi
         parentId?: string;
         sortOrder?: number;
         headers?: Record<string, string>;
-    } & ConditionalWriteOptions): Promise<T>;
+    } & ConditionalWriteOptions): Promise<RevisedContent<T>>;
     /**
      * Delete a content item by ID
      */
@@ -856,15 +861,19 @@ declare class ContentClient<T extends BaseContent = BaseContent, R extends Readi
      * 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[]>;
@@ -964,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']>;
 /**
@@ -978,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). */
@@ -1323,9 +1306,14 @@ declare class AssetUploadBuilder<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> extends Reading {
+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;
@@ -1341,19 +1329,19 @@ declare class AssetClient<T extends BaseContent = BaseContent, R extends Reading
      * 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, AssetResponseReading<R>>;
+    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>, AssetResponseReading<R>>;
+    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>, P[number]> | null>;
+    }): Promise<ReadWith<AssetResponseReading<R, T>, P[number]> | null>;
     fetchOne(id: string, options?: {
         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
@@ -3726,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 };

package/dist/{index-Pw0onkJe.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-B9RfZVF1.js';
-import { W as Reading, _ as UntypedReading, M as CheckedIncludes, X as ReadWith, aX as components, aY as CheckedInclude, aW as paths, a6 as InferContentType, P as ContentReading, an as InferAssetType, J as AssetReading, ae as InferSingleton, Z as SingletonReading, aj as InferSettingsGroup, Y as SettingsReading } from './include-paths-CrJNTsMl.js';
-import { a as SchemaDefinition, b as SchemaContentTypeNames, j as SchemaEntryOf, al as FilterOperator, h as SchemaAssetTypeNames, c as SchemaSingletonNames, g as SchemaSettingsGroupNames, e as SchemaQueryNames, f as SchemaLocaleCodes } from './define-schema-mrEZbY1h.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';
 
@@ -323,10 +322,14 @@ 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
      */
@@ -657,9 +660,9 @@ 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) */
@@ -724,10 +727,10 @@ declare class ContentClient<T extends BaseContent = BaseContent, R extends Readi
     /**
      * Fetch content with query options
      */
-    fetch<const P extends readonly string[]>(options: Omit<ContentFetchOptions<T>, 'include'> & {
+    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>, 'include'>): Promise<T[]>;
+    fetch(options?: Omit<ContentFetchOptions<T, R>, 'include'>): Promise<T[]>;
     /**
      * Fetch a single content item by ID
      * @param id - Entry ID or slug
@@ -781,7 +784,7 @@ declare class ContentClient<T extends BaseContent = BaseContent, R extends Readi
      * @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
@@ -805,6 +808,8 @@ declare class ContentClient<T extends BaseContent = BaseContent, R extends Readi
      *   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;
@@ -812,7 +817,7 @@ declare class ContentClient<T extends BaseContent = BaseContent, R extends Readi
         parentId?: string;
         sortOrder?: number;
         headers?: Record<string, string>;
-    } & ConditionalWriteOptions): Promise<T>;
+    } & ConditionalWriteOptions): Promise<RevisedContent<T>>;
     /**
      * Delete a content item by ID
      */
@@ -856,15 +861,19 @@ declare class ContentClient<T extends BaseContent = BaseContent, R extends Readi
      * 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[]>;
@@ -964,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']>;
 /**
@@ -978,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). */
@@ -1323,9 +1306,14 @@ declare class AssetUploadBuilder<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> extends Reading {
+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;
@@ -1341,19 +1329,19 @@ declare class AssetClient<T extends BaseContent = BaseContent, R extends Reading
      * 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, AssetResponseReading<R>>;
+    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>, AssetResponseReading<R>>;
+    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>, P[number]> | null>;
+    }): Promise<ReadWith<AssetResponseReading<R, T>, P[number]> | null>;
     fetchOne(id: string, options?: {
         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
@@ -3726,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 };