@relyio/sdk 0.10.0 → 0.11.0

package/dist/{chunk-IGHYC2WM.js → chunk-2TIJLV2X.js}

@@ -690,5 +690,5 @@ __name(component, "component");
 var fields = fields_exports;
 
 export { BUILT_IN_ROLES, BUILT_IN_ROLE_ACTIONS, ROLE_ACTIONS, buildFallbackChain, defineAssetType, defineComponent, defineContentType, defineContentTypeWorkflow, defineLocale, defineQuery, defineRole, defineSchema, defineSettingsGroup, defineSingleton, defineSingletonContentType, defineView, defineWorkflow, defineWorkflowStage, fields, fieldset, findDefaultLocale, findWorkflowStage, getActiveLocales, getBuiltInRoleActions, getFirstWorkflowStage, getLocaleCodes, getNextWorkflowStage, getWorkflowStageIds, isBuiltInRole, isFinalWorkflowStage, isLocaleDefinition, isRoleDefinition, isWorkflowDefinition, isWorkflowStageDefinition };
-//# sourceMappingURL=chunk-IGHYC2WM.js.map
-//# sourceMappingURL=chunk-IGHYC2WM.js.map
+//# sourceMappingURL=chunk-2TIJLV2X.js.map
+//# sourceMappingURL=chunk-2TIJLV2X.js.map

package/dist/{chunk-DC4QLAI3.cjs → chunk-4HTIU5YE.cjs}

@@ -6346,5 +6346,5 @@ exports.matchRoute = matchRoute;
 exports.serviceInstructedDelayMs = serviceInstructedDelayMs;
 exports.sleep = sleep;
 exports.validateFile = validateFile;
-//# sourceMappingURL=chunk-DC4QLAI3.cjs.map
-//# sourceMappingURL=chunk-DC4QLAI3.cjs.map
+//# sourceMappingURL=chunk-4HTIU5YE.cjs.map
+//# sourceMappingURL=chunk-4HTIU5YE.cjs.map

package/dist/{chunk-2L5JUW7O.js → chunk-7GLDVHIH.js}

@@ -6285,5 +6285,5 @@ function randomClientId() {
 __name(randomClientId, "randomClientId");
 
 export { AdhocQueryBuilder, AdhocQueryClient, AssetClient, AssetFileBuilder, AssetUploadBuilder, AuthorizationError, AutocompleteBuilder, BaseValidationError, BatchBuilder, BatchClient, ChangesExpiredError, ConnectionError, ContentByIdBuilder, ContentClient, ContentQueryBuilder, ErrorMapper, FileUploadError, FileValidationError, HttpClient, InvalidApiKeyError, InvalidPayloadError, LIVE_KEEPALIVE_INTERVAL_MS, LIVE_SOCKET_OPEN_TIMEOUT_MS, LiveEdgeError, MethodNotAllowedError, MissingApiKeyError, NetworkError, PUBLISHABLE_KEY_PREFIX, PayloadTooLargeError, PlanFeatureUnavailableError, RateLimitError, ReadOnlyKeyError, ResourceConflictError, ResourceExpiredError, ResourceNotFoundError, SDKError, SearchBuilder, SearchClient, ServerError, ServiceIndeterminateError, SettingsClient, SimilarBuilder, SingletonClient, TimeoutError, TransactionRolledBackError, TypedRelyIOClient, UnknownContractError, UsageQuotaExceededError, VISITOR_ADMISSION_RETRY_AFTER_SECONDS, ValidationError, createClient, entityTagOf, isAborted, isAssetEntry, isPublishableKey, isResourceNotFound, matchRoute, serviceInstructedDelayMs, sleep, validateFile };
-//# sourceMappingURL=chunk-2L5JUW7O.js.map
-//# sourceMappingURL=chunk-2L5JUW7O.js.map
+//# sourceMappingURL=chunk-7GLDVHIH.js.map
+//# sourceMappingURL=chunk-7GLDVHIH.js.map

package/dist/{chunk-2HP566NI.cjs → chunk-PO7CUR5U.cjs}

@@ -725,5 +725,5 @@ exports.isLocaleDefinition = isLocaleDefinition;
 exports.isRoleDefinition = isRoleDefinition;
 exports.isWorkflowDefinition = isWorkflowDefinition;
 exports.isWorkflowStageDefinition = isWorkflowStageDefinition;
-//# sourceMappingURL=chunk-2HP566NI.cjs.map
-//# sourceMappingURL=chunk-2HP566NI.cjs.map
+//# sourceMappingURL=chunk-PO7CUR5U.cjs.map
+//# sourceMappingURL=chunk-PO7CUR5U.cjs.map

package/dist/client/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkDC4QLAI3_cjs = require('../chunk-DC4QLAI3.cjs');
+var chunk4HTIU5YE_cjs = require('../chunk-4HTIU5YE.cjs');
 require('../chunk-LSRPMNPT.cjs');
 require('../chunk-TZL374LS.cjs');
 require('../chunk-MWMSFIWN.cjs');
@@ -9,11 +9,11 @@ require('../chunk-MWMSFIWN.cjs');
 
 Object.defineProperty(exports, "TypedRelyIOClient", {
   enumerable: true,
-  get: function () { return chunkDC4QLAI3_cjs.TypedRelyIOClient; }
+  get: function () { return chunk4HTIU5YE_cjs.TypedRelyIOClient; }
 });
 Object.defineProperty(exports, "createClient", {
   enumerable: true,
-  get: function () { return chunkDC4QLAI3_cjs.createClient; }
+  get: function () { return chunk4HTIU5YE_cjs.createClient; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/client/index.d.cts

@@ -1,6 +1,6 @@
-export { e as ClientSchema, R as Register, f as RegisteredSchema, d as TypedClientConfig, T as TypedRelyIOClient, c as createClient } from '../index-KuYgc7eG.cjs';
-import '../index-NnLCwSqF.cjs';
-import '../define-content-type-DfnTu26S.cjs';
-import '../define-schema-W-0u1Jg1.cjs';
+export { e as ClientSchema, R as Register, f as RegisteredSchema, d as TypedClientConfig, T as TypedRelyIOClient, c as createClient } from '../index-MLAFUuco.cjs';
+import '../index-BM42r4yg.cjs';
+import '../define-content-type-ENAod5Ve.cjs';
+import '../define-schema-DqpipEHv.cjs';
 import './live-visitor.js';
 import '../dev-handshake/index.cjs';

package/dist/client/index.d.ts

@@ -1,6 +1,6 @@
-export { e as ClientSchema, R as Register, f as RegisteredSchema, d as TypedClientConfig, T as TypedRelyIOClient, c as createClient } from '../index-rLEBSFvK.js';
-import '../index-B9hDmCho.js';
-import '../define-content-type-DfnTu26S.js';
-import '../define-schema-rbTrXxNN.js';
+export { e as ClientSchema, R as Register, f as RegisteredSchema, d as TypedClientConfig, T as TypedRelyIOClient, c as createClient } from '../index-BKEAYvvz.js';
+import '../index-C73cK2Tt.js';
+import '../define-content-type-ENAod5Ve.js';
+import '../define-schema-CVi8nwc7.js';
 import './live-visitor.js';
 import '../dev-handshake/index.js';

package/dist/client/index.js

@@ -1,4 +1,4 @@
-export { TypedRelyIOClient, createClient } from '../chunk-2L5JUW7O.js';
+export { TypedRelyIOClient, createClient } from '../chunk-7GLDVHIH.js';
 import '../chunk-BBUB7C2Z.js';
 import '../chunk-H6IBQSMM.js';
 import '../chunk-XQ4QHWZE.js';

package/dist/{define-content-type-DfnTu26S.d.cts → define-content-type-ENAod5Ve.d.cts}

@@ -1058,14 +1058,14 @@ interface components {
             localeStatus?: 'archived' | 'draft' | 'published';
             /** @description Whether `locale` has unpublished changes of its own. */
             localeHasDraft: boolean;
-            /** @description Every locale holding unpublished content, sorted. A shared-field draft is listed under the default locale. */
+            /** @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;
             /** @description The locale the request named, when it named one other than the default. On `?locales=a,b,c` it is always sent: the primary, or `*` when the list names as many locales as the entry has — as on `?locale=*`. */
             requestedLocale?: string;
             /** @description The schema’s default locale. */
             defaultLocale: string;
-            /** @description Whether the shared (non-localized) fields have unpublished changes. */
-            hasDraft: boolean;
             /** @description Each field whose value came from another locale, mapped to that locale. Absent when none did. */
             localeFallbacksApplied?: {
                 [key: string]: string;
@@ -1354,9 +1354,9 @@ interface components {
             localeStatus?: 'archived' | 'draft' | 'published';
             /** @description Whether `locale` has unpublished changes of its own. */
             localeHasDraft: boolean;
-            /** @description Every locale holding unpublished content, sorted. A shared-field draft is listed under the default locale. */
+            /** @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. */
+            /** @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
@@ -1407,8 +1407,10 @@ interface components {
             localeStatus?: 'archived' | 'draft' | 'published';
             /** @description Whether `locale` has unpublished changes of its own. */
             localeHasDraft: boolean;
-            /** @description Every locale holding unpublished content, sorted. A shared-field draft is listed under the default locale. */
+            /** @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 group was last written.
@@ -1439,8 +1441,10 @@ interface components {
             localeStatus?: 'archived' | 'draft' | 'published';
             /** @description Whether `locale` has unpublished changes of its own. */
             localeHasDraft: boolean;
-            /** @description Every locale holding unpublished content, sorted. A shared-field draft is listed under the default locale. */
+            /** @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 group was last written.
@@ -1482,9 +1486,9 @@ interface components {
             localeStatus?: 'archived' | 'draft' | 'published';
             /** @description Whether `locale` has unpublished changes of its own. */
             localeHasDraft: boolean;
-            /** @description Every locale holding unpublished content, sorted. A shared-field draft is listed under the default locale. */
+            /** @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. */
+            /** @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
@@ -6829,7 +6833,10 @@ interface DateConfig extends BaseFieldConfig {
 interface DateTimeConfig extends BaseFieldConfig {
     minDateTime?: string;
     maxDateTime?: string;
-    /** Store the instant in UTC (`'UTC'`), or keep the author's local time (`'local'`). */
+    /**
+     * Show the instant in UTC (`'UTC'`) or in the author's local time (`'local'`) in the editor. The
+     * instant is stored in UTC either way.
+     */
     timeZoneHandling?: 'UTC' | 'local';
     defaultValue?: string;
 }
@@ -7451,8 +7458,9 @@ type InferAssetType<T extends AnyAssetTypeDefinition, S extends FieldSchemaConte
  * typed by one table. The types describe **what a read returns**, which is not always what a write
  * accepts:
  *
- * - `richText` is the stored HTML string; `date` is `YYYY-MM-DD` and `dateTime` an ISO 8601 string —
- *   the client does not revive dates.
+ * - `richText` is the stored HTML string; `date` is `YYYY-MM-DD` and `dateTime` an ISO 8601 string
+ *   in UTC at millisecond precision (`2026-10-01T04:30:00.000Z`), whatever offset it was written in
+ *   — the client does not revive dates.
  * - A `reference` is the target's id until `include` names it, and then the target entry itself.
  *   The type cannot see `include`, so it is both: `string | <entry>`. A single reference whose target
  *   was deleted with `onTargetDelete: 'nullify'` is `null`.
@@ -7508,7 +7516,7 @@ type FieldValueByType<C, S extends Context> = OverEveryFieldType<{
     enum: EnumValue<C>;
     /** `YYYY-MM-DD`. */
     date: string;
-    /** ISO 8601. */
+    /** ISO 8601 in UTC at millisecond precision: `2026-10-01T04:30:00.000Z`. */
     dateTime: string;
     reference: ReferenceValue<C, S>;
     tags: string[];
@@ -7769,8 +7777,13 @@ type EntryMetadata = components['schemas']['EntryMetadata'];
  * settings group's alike (`INV-LM-PUBLICATION-IS-REPORTED-PER-LOCALE`): a `Pick` of the document's
  * {@link EntryMetadata}, so this package holds no copy of them. `localeStatus` is absent when the
  * locale has no content of its own.
+ *
+ * Unpublished work comes in two kinds, reported apart: `draftLocales` names the locales with edits
+ * of their own, and `hasDraft` is a change to the shared (non-localized) fields. Publishing any
+ * locale makes a shared change live, so it is pending in every locale and no locale code is listed
+ * for it. A locale has unpublished work when `draftLocales` names it or `hasDraft` is `true`.
  */
-type LocalePublicationFields = Pick<EntryMetadata, 'localeStatus' | 'localeHasDraft' | 'draftLocales'>;
+type LocalePublicationFields = Pick<EntryMetadata, 'localeStatus' | 'localeHasDraft' | 'draftLocales' | 'hasDraft'>;
 /**
  * Infer the TypeScript type of an entry from a content type definition: every field it declares,
  * directly or through fieldsets, typed as a read returns it (`INV-SS-TYPES-INFERRED`), plus

package/dist/{define-content-type-DfnTu26S.d.ts → define-content-type-ENAod5Ve.d.ts}

@@ -1058,14 +1058,14 @@ interface components {
             localeStatus?: 'archived' | 'draft' | 'published';
             /** @description Whether `locale` has unpublished changes of its own. */
             localeHasDraft: boolean;
-            /** @description Every locale holding unpublished content, sorted. A shared-field draft is listed under the default locale. */
+            /** @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;
             /** @description The locale the request named, when it named one other than the default. On `?locales=a,b,c` it is always sent: the primary, or `*` when the list names as many locales as the entry has — as on `?locale=*`. */
             requestedLocale?: string;
             /** @description The schema’s default locale. */
             defaultLocale: string;
-            /** @description Whether the shared (non-localized) fields have unpublished changes. */
-            hasDraft: boolean;
             /** @description Each field whose value came from another locale, mapped to that locale. Absent when none did. */
             localeFallbacksApplied?: {
                 [key: string]: string;
@@ -1354,9 +1354,9 @@ interface components {
             localeStatus?: 'archived' | 'draft' | 'published';
             /** @description Whether `locale` has unpublished changes of its own. */
             localeHasDraft: boolean;
-            /** @description Every locale holding unpublished content, sorted. A shared-field draft is listed under the default locale. */
+            /** @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. */
+            /** @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
@@ -1407,8 +1407,10 @@ interface components {
             localeStatus?: 'archived' | 'draft' | 'published';
             /** @description Whether `locale` has unpublished changes of its own. */
             localeHasDraft: boolean;
-            /** @description Every locale holding unpublished content, sorted. A shared-field draft is listed under the default locale. */
+            /** @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 group was last written.
@@ -1439,8 +1441,10 @@ interface components {
             localeStatus?: 'archived' | 'draft' | 'published';
             /** @description Whether `locale` has unpublished changes of its own. */
             localeHasDraft: boolean;
-            /** @description Every locale holding unpublished content, sorted. A shared-field draft is listed under the default locale. */
+            /** @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 group was last written.
@@ -1482,9 +1486,9 @@ interface components {
             localeStatus?: 'archived' | 'draft' | 'published';
             /** @description Whether `locale` has unpublished changes of its own. */
             localeHasDraft: boolean;
-            /** @description Every locale holding unpublished content, sorted. A shared-field draft is listed under the default locale. */
+            /** @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. */
+            /** @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
@@ -6829,7 +6833,10 @@ interface DateConfig extends BaseFieldConfig {
 interface DateTimeConfig extends BaseFieldConfig {
     minDateTime?: string;
     maxDateTime?: string;
-    /** Store the instant in UTC (`'UTC'`), or keep the author's local time (`'local'`). */
+    /**
+     * Show the instant in UTC (`'UTC'`) or in the author's local time (`'local'`) in the editor. The
+     * instant is stored in UTC either way.
+     */
     timeZoneHandling?: 'UTC' | 'local';
     defaultValue?: string;
 }
@@ -7451,8 +7458,9 @@ type InferAssetType<T extends AnyAssetTypeDefinition, S extends FieldSchemaConte
  * typed by one table. The types describe **what a read returns**, which is not always what a write
  * accepts:
  *
- * - `richText` is the stored HTML string; `date` is `YYYY-MM-DD` and `dateTime` an ISO 8601 string —
- *   the client does not revive dates.
+ * - `richText` is the stored HTML string; `date` is `YYYY-MM-DD` and `dateTime` an ISO 8601 string
+ *   in UTC at millisecond precision (`2026-10-01T04:30:00.000Z`), whatever offset it was written in
+ *   — the client does not revive dates.
  * - A `reference` is the target's id until `include` names it, and then the target entry itself.
  *   The type cannot see `include`, so it is both: `string | <entry>`. A single reference whose target
  *   was deleted with `onTargetDelete: 'nullify'` is `null`.
@@ -7508,7 +7516,7 @@ type FieldValueByType<C, S extends Context> = OverEveryFieldType<{
     enum: EnumValue<C>;
     /** `YYYY-MM-DD`. */
     date: string;
-    /** ISO 8601. */
+    /** ISO 8601 in UTC at millisecond precision: `2026-10-01T04:30:00.000Z`. */
     dateTime: string;
     reference: ReferenceValue<C, S>;
     tags: string[];
@@ -7769,8 +7777,13 @@ type EntryMetadata = components['schemas']['EntryMetadata'];
  * settings group's alike (`INV-LM-PUBLICATION-IS-REPORTED-PER-LOCALE`): a `Pick` of the document's
  * {@link EntryMetadata}, so this package holds no copy of them. `localeStatus` is absent when the
  * locale has no content of its own.
+ *
+ * Unpublished work comes in two kinds, reported apart: `draftLocales` names the locales with edits
+ * of their own, and `hasDraft` is a change to the shared (non-localized) fields. Publishing any
+ * locale makes a shared change live, so it is pending in every locale and no locale code is listed
+ * for it. A locale has unpublished work when `draftLocales` names it or `hasDraft` is `true`.
  */
-type LocalePublicationFields = Pick<EntryMetadata, 'localeStatus' | 'localeHasDraft' | 'draftLocales'>;
+type LocalePublicationFields = Pick<EntryMetadata, 'localeStatus' | 'localeHasDraft' | 'draftLocales' | 'hasDraft'>;
 /**
  * Infer the TypeScript type of an entry from a content type definition: every field it declares,
  * directly or through fieldsets, typed as a read returns it (`INV-SS-TYPES-INFERRED`), plus

package/dist/{define-schema-W-0u1Jg1.d.cts → define-schema-CVi8nwc7.d.ts}

@@ -1,4 +1,4 @@
-import { A as AnyFieldDefinition, c as FieldDefinition, k as AIConfig, v as FieldSchemaContext, x as FieldValues, y as DeclaredFields, aK as components, P as ContentTypeDefinition, a0 as SingletonContentTypeDefinition, aH as WorkflowDefinition, a9 as AssetTypeDefinition, W as InferContentType } from './define-content-type-DfnTu26S.cjs';
+import { A as AnyFieldDefinition, c as FieldDefinition, k as AIConfig, v as FieldSchemaContext, x as FieldValues, y as DeclaredFields, aK as components, P as ContentTypeDefinition, a0 as SingletonContentTypeDefinition, aH as WorkflowDefinition, a9 as AssetTypeDefinition, W as InferContentType } from './define-content-type-ENAod5Ve.js';
 
 /**
  * Component definition matching @relyio/schema ComponentSchema
@@ -928,7 +928,11 @@ type ViewFilterValue = string | number | boolean | null | (string | number)[] |
  */
 interface ViewFilterCondition {
     /**
-     * Field ID to filter on
+     * The Property to filter on, as the Studio's entry list names it: `fields.<id>` for a field your
+     * schema declares (`fields.seo.title` for a component's sub-field), `_metadata.<id>` for a system
+     * field — `_metadata.status`, `_metadata.createdAt`, `_metadata.updatedAt`. So a field called
+     * `status` (`fields.status`) and the entry's own lifecycle (`_metadata.status`) are both
+     * filterable.
      */
     field: string;
     /**
@@ -994,7 +998,9 @@ interface ViewConfig {
      */
     metadataFields?: string[];
     /**
-     * Default sort configuration (optional)
+     * Default sort (optional). `field` names the Property to sort by, as a filter names one —
+     * `fields.<id>` or `_metadata.<id>` — and deploy refuses one the view's entries cannot be sorted
+     * by. `columns` and `metadataFields` are display settings and name field IDs as written.
      */
     sort?: {
         field: string;
@@ -1025,25 +1031,25 @@ interface ViewDefinition extends ViewConfig {
  * columns, and metadata settings.
  *
  * @example
- * const publishedPosts = defineView('publishedPosts', {
- *   name: 'Published Posts',
- *   description: 'All published blog posts',
+ * const featuredPosts = defineView('featuredPosts', {
+ *   name: 'Featured Posts',
+ *   description: 'Blog posts marked as featured',
  *   icon: '📝',
  *   scope: { type: 'contentType', contentType: 'post' },
  *   filters: [
- *     { field: 'status', operator: 'is', value: 'published' }
+ *     { field: 'fields.featured', operator: 'is', value: true }
  *   ],
  *   columns: ['title', 'author', 'publishedAt'],
  *   metadataFields: ['category', 'views'],
- *   sort: { field: 'publishedAt', direction: 'desc' }
+ *   sort: { field: '_metadata.publishedAt', direction: 'desc' }
  * })
  *
  * @example
- * const draftContent = defineView('draftContent', {
- *   name: 'Drafts',
+ * const archivedContent = defineView('archivedContent', {
+ *   name: 'Archived',
  *   scope: { type: 'all' },
  *   filters: [
- *     { field: 'status', operator: 'is', value: 'draft' }
+ *     { field: '_metadata.status', operator: 'is', value: 'archived' }
  *   ]
  * })
  *

package/dist/{define-schema-rbTrXxNN.d.ts → define-schema-DqpipEHv.d.cts}

@@ -1,4 +1,4 @@
-import { A as AnyFieldDefinition, c as FieldDefinition, k as AIConfig, v as FieldSchemaContext, x as FieldValues, y as DeclaredFields, aK as components, P as ContentTypeDefinition, a0 as SingletonContentTypeDefinition, aH as WorkflowDefinition, a9 as AssetTypeDefinition, W as InferContentType } from './define-content-type-DfnTu26S.js';
+import { A as AnyFieldDefinition, c as FieldDefinition, k as AIConfig, v as FieldSchemaContext, x as FieldValues, y as DeclaredFields, aK as components, P as ContentTypeDefinition, a0 as SingletonContentTypeDefinition, aH as WorkflowDefinition, a9 as AssetTypeDefinition, W as InferContentType } from './define-content-type-ENAod5Ve.cjs';
 
 /**
  * Component definition matching @relyio/schema ComponentSchema
@@ -928,7 +928,11 @@ type ViewFilterValue = string | number | boolean | null | (string | number)[] |
  */
 interface ViewFilterCondition {
     /**
-     * Field ID to filter on
+     * The Property to filter on, as the Studio's entry list names it: `fields.<id>` for a field your
+     * schema declares (`fields.seo.title` for a component's sub-field), `_metadata.<id>` for a system
+     * field — `_metadata.status`, `_metadata.createdAt`, `_metadata.updatedAt`. So a field called
+     * `status` (`fields.status`) and the entry's own lifecycle (`_metadata.status`) are both
+     * filterable.
      */
     field: string;
     /**
@@ -994,7 +998,9 @@ interface ViewConfig {
      */
     metadataFields?: string[];
     /**
-     * Default sort configuration (optional)
+     * Default sort (optional). `field` names the Property to sort by, as a filter names one —
+     * `fields.<id>` or `_metadata.<id>` — and deploy refuses one the view's entries cannot be sorted
+     * by. `columns` and `metadataFields` are display settings and name field IDs as written.
      */
     sort?: {
         field: string;
@@ -1025,25 +1031,25 @@ interface ViewDefinition extends ViewConfig {
  * columns, and metadata settings.
  *
  * @example
- * const publishedPosts = defineView('publishedPosts', {
- *   name: 'Published Posts',
- *   description: 'All published blog posts',
+ * const featuredPosts = defineView('featuredPosts', {
+ *   name: 'Featured Posts',
+ *   description: 'Blog posts marked as featured',
  *   icon: '📝',
  *   scope: { type: 'contentType', contentType: 'post' },
  *   filters: [
- *     { field: 'status', operator: 'is', value: 'published' }
+ *     { field: 'fields.featured', operator: 'is', value: true }
  *   ],
  *   columns: ['title', 'author', 'publishedAt'],
  *   metadataFields: ['category', 'views'],
- *   sort: { field: 'publishedAt', direction: 'desc' }
+ *   sort: { field: '_metadata.publishedAt', direction: 'desc' }
  * })
  *
  * @example
- * const draftContent = defineView('draftContent', {
- *   name: 'Drafts',
+ * const archivedContent = defineView('archivedContent', {
+ *   name: 'Archived',
  *   scope: { type: 'all' },
  *   filters: [
- *     { field: 'status', operator: 'is', value: 'draft' }
+ *     { field: '_metadata.status', operator: 'is', value: 'archived' }
  *   ]
  * })
  *

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

@@ -1,6 +1,6 @@
-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-B9hDmCho.js';
-import { aK as components, aJ as paths, W as InferContentType, aa as InferAssetType, a3 as InferSingleton } from './define-content-type-DfnTu26S.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-rbTrXxNN.js';
+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 { VisitorResyncReason } from './live-visitor.js';
 import { DevUnreadableReason } from './dev-handshake/index.js';
 
@@ -863,9 +863,9 @@ declare class ContentClient<T extends BaseContent = BaseContent> {
 /**
  * Upload/processing error taxonomy (plan 17, 00b Step 4).
  *
- * A **thin customer-side mirror** of the realtime-contracts `FileErrorCode`
+ * A **thin customer-side mirror** of the live-contracts `FileErrorCode`
  * (correction C6 — the SDK must not import the server/Studio contracts package).
- * Keep the members in sync with `@relyio/realtime-contracts`.
+ * Keep the members in sync with `@relyio/live-contracts`.
  *
  * Written once, as values, because a processing failure's code arrives as a string the service
  * stored and has to be recognised at runtime; `FileErrorCode` is read off this list. The module is
@@ -876,7 +876,7 @@ declare const FILE_ERROR_CODES: readonly ["UPLOAD_TOO_LARGE", "UNSUPPORTED_MIME"
 
 /**
  * Upload/processing error taxonomy (plan 17, 00b Step 4): a customer-side mirror of the
- * realtime-contracts `FileErrorCode`, read off the list in `./file-error-codes`.
+ * live-contracts `FileErrorCode`, read off the list in `./file-error-codes`.
  */
 type FileErrorCode = (typeof FILE_ERROR_CODES)[number];
 /**

package/dist/{index-NnLCwSqF.d.cts → index-BM42r4yg.d.cts}

@@ -1,4 +1,4 @@
-import { aJ as paths, Q as EntryMetadata, aK as components } from './define-content-type-DfnTu26S.cjs';
+import { aJ as paths, Q as EntryMetadata, aK as components } from './define-content-type-ENAod5Ve.cjs';
 
 /**
  * Where the SDK's transport gets its truth.

package/dist/{index-B9hDmCho.d.ts → index-C73cK2Tt.d.ts}

@@ -1,4 +1,4 @@
-import { aJ as paths, Q as EntryMetadata, aK as components } from './define-content-type-DfnTu26S.js';
+import { aJ as paths, Q as EntryMetadata, aK as components } from './define-content-type-ENAod5Ve.js';
 
 /**
  * Where the SDK's transport gets its truth.

package/dist/{index-KuYgc7eG.d.cts → index-MLAFUuco.d.cts}

@@ -1,6 +1,6 @@
-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-NnLCwSqF.cjs';
-import { aK as components, aJ as paths, W as InferContentType, aa as InferAssetType, a3 as InferSingleton } from './define-content-type-DfnTu26S.cjs';
-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-W-0u1Jg1.cjs';
+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-BM42r4yg.cjs';
+import { aK as components, aJ as paths, W as InferContentType, aa as InferAssetType, a3 as InferSingleton } from './define-content-type-ENAod5Ve.cjs';
+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-DqpipEHv.cjs';
 import { VisitorResyncReason } from './live-visitor.js';
 import { DevUnreadableReason } from './dev-handshake/index.cjs';
 
@@ -863,9 +863,9 @@ declare class ContentClient<T extends BaseContent = BaseContent> {
 /**
  * Upload/processing error taxonomy (plan 17, 00b Step 4).
  *
- * A **thin customer-side mirror** of the realtime-contracts `FileErrorCode`
+ * A **thin customer-side mirror** of the live-contracts `FileErrorCode`
  * (correction C6 — the SDK must not import the server/Studio contracts package).
- * Keep the members in sync with `@relyio/realtime-contracts`.
+ * Keep the members in sync with `@relyio/live-contracts`.
  *
  * Written once, as values, because a processing failure's code arrives as a string the service
  * stored and has to be recognised at runtime; `FileErrorCode` is read off this list. The module is
@@ -876,7 +876,7 @@ declare const FILE_ERROR_CODES: readonly ["UPLOAD_TOO_LARGE", "UNSUPPORTED_MIME"
 
 /**
  * Upload/processing error taxonomy (plan 17, 00b Step 4): a customer-side mirror of the
- * realtime-contracts `FileErrorCode`, read off the list in `./file-error-codes`.
+ * live-contracts `FileErrorCode`, read off the list in `./file-error-codes`.
  */
 type FileErrorCode = (typeof FILE_ERROR_CODES)[number];
 /**