@relyio/sdk 0.9.0 → 0.11.0

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

@@ -534,6 +534,14 @@ function defineView(id, config) {
   if (!config.scope?.type) {
     throw new Error(`View '${id}' must have a valid scope`);
   }
+  const grouped = (config.filters ?? []).findIndex(
+    (filter) => typeof filter === "object" && filter !== null && "conditions" in filter
+  );
+  if (grouped !== -1) {
+    throw new Error(
+      `View '${id}' filter ${grouped} is a filter group: a view's filters are a flat list, joined by AND. List each of its conditions as a filter of its own, or use 'isAnyOf' for an OR within one field.`
+    );
+  }
   if (config.slug !== void 0 && !/^[a-z][a-z0-9-]*$/.test(config.slug)) {
     throw new Error(
       `View '${id}' slug '${config.slug}' must be lowercase, start with a letter, and contain only letters, numbers, and hyphens`
@@ -682,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-YEJUMW4X.js.map
-//# sourceMappingURL=chunk-YEJUMW4X.js.map
+//# sourceMappingURL=chunk-2TIJLV2X.js.map
+//# sourceMappingURL=chunk-2TIJLV2X.js.map

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

@@ -412,7 +412,7 @@ var _InvalidPayloadError = class _InvalidPayloadError extends BaseValidationErro
 chunkMWMSFIWN_cjs.__name(_InvalidPayloadError, "InvalidPayloadError");
 var InvalidPayloadError = _InvalidPayloadError;
 
-// ../../platform/api-contract/dist/chunk-PYZCLRXR.js
+// ../../platform/api-contract/dist/chunk-46347LG2.js
 function defineRoute(route) {
   if (route.kind === "raw" && route.standardShape === void 0) {
     throw new Error("kind 'raw' requires a named StandardShape");
@@ -426,6 +426,16 @@ function defineRoute(route) {
   if (route.kind === "collection" && route.page === void 0) {
     throw new Error("kind 'collection' requires a page dialect");
   }
+  if (route.queues === true) {
+    if (route.kind !== "object" && route.kind !== "empty") {
+      throw new Error(
+        `kind '${route.kind}' cannot declare \`queues\`: only an object or empty route answers 202 beside its own status`
+      );
+    }
+    if (route.kind === "object" && route.success === 202) {
+      throw new Error("a route whose own status is 202 cannot also declare `queues`");
+    }
+  }
   if ((route.kind === "object" || route.kind === "collection") && route.negotiated !== void 0) {
     refuseMismatchedAlternate(route, route.negotiated["text/event-stream"]);
   }
@@ -897,6 +907,7 @@ var DECLARED_PATHS = {
   "/internal/media/resolve": true,
   "/internal/usage/cycle": true,
   "/internal/usage/ingest": true,
+  "/internal/usage/stops": true,
   "/v1/{contentType}": true,
   "/v1/{contentType}/{id}": true,
   "/v1/{contentType}/{id}/children": true,
@@ -6335,5 +6346,5 @@ exports.matchRoute = matchRoute;
 exports.serviceInstructedDelayMs = serviceInstructedDelayMs;
 exports.sleep = sleep;
 exports.validateFile = validateFile;
-//# sourceMappingURL=chunk-SPFRDXAF.cjs.map
-//# sourceMappingURL=chunk-SPFRDXAF.cjs.map
+//# sourceMappingURL=chunk-4HTIU5YE.cjs.map
+//# sourceMappingURL=chunk-4HTIU5YE.cjs.map

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

@@ -410,7 +410,7 @@ var _InvalidPayloadError = class _InvalidPayloadError extends BaseValidationErro
 __name(_InvalidPayloadError, "InvalidPayloadError");
 var InvalidPayloadError = _InvalidPayloadError;
 
-// ../../platform/api-contract/dist/chunk-PYZCLRXR.js
+// ../../platform/api-contract/dist/chunk-46347LG2.js
 function defineRoute(route) {
   if (route.kind === "raw" && route.standardShape === void 0) {
     throw new Error("kind 'raw' requires a named StandardShape");
@@ -424,6 +424,16 @@ function defineRoute(route) {
   if (route.kind === "collection" && route.page === void 0) {
     throw new Error("kind 'collection' requires a page dialect");
   }
+  if (route.queues === true) {
+    if (route.kind !== "object" && route.kind !== "empty") {
+      throw new Error(
+        `kind '${route.kind}' cannot declare \`queues\`: only an object or empty route answers 202 beside its own status`
+      );
+    }
+    if (route.kind === "object" && route.success === 202) {
+      throw new Error("a route whose own status is 202 cannot also declare `queues`");
+    }
+  }
   if ((route.kind === "object" || route.kind === "collection") && route.negotiated !== void 0) {
     refuseMismatchedAlternate(route, route.negotiated["text/event-stream"]);
   }
@@ -895,6 +905,7 @@ var DECLARED_PATHS = {
   "/internal/media/resolve": true,
   "/internal/usage/cycle": true,
   "/internal/usage/ingest": true,
+  "/internal/usage/stops": true,
   "/v1/{contentType}": true,
   "/v1/{contentType}/{id}": true,
   "/v1/{contentType}/{id}/children": true,
@@ -6274,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-LGNJIGHL.js.map
-//# sourceMappingURL=chunk-LGNJIGHL.js.map
+//# sourceMappingURL=chunk-7GLDVHIH.js.map
+//# sourceMappingURL=chunk-7GLDVHIH.js.map

package/dist/{chunk-72UK5U7T.cjs → chunk-PO7CUR5U.cjs}

@@ -536,6 +536,14 @@ function defineView(id, config) {
   if (!config.scope?.type) {
     throw new Error(`View '${id}' must have a valid scope`);
   }
+  const grouped = (config.filters ?? []).findIndex(
+    (filter) => typeof filter === "object" && filter !== null && "conditions" in filter
+  );
+  if (grouped !== -1) {
+    throw new Error(
+      `View '${id}' filter ${grouped} is a filter group: a view's filters are a flat list, joined by AND. List each of its conditions as a filter of its own, or use 'isAnyOf' for an OR within one field.`
+    );
+  }
   if (config.slug !== void 0 && !/^[a-z][a-z0-9-]*$/.test(config.slug)) {
     throw new Error(
       `View '${id}' slug '${config.slug}' must be lowercase, start with a letter, and contain only letters, numbers, and hyphens`
@@ -717,5 +725,5 @@ exports.isLocaleDefinition = isLocaleDefinition;
 exports.isRoleDefinition = isRoleDefinition;
 exports.isWorkflowDefinition = isWorkflowDefinition;
 exports.isWorkflowStageDefinition = isWorkflowStageDefinition;
-//# sourceMappingURL=chunk-72UK5U7T.cjs.map
-//# sourceMappingURL=chunk-72UK5U7T.cjs.map
+//# sourceMappingURL=chunk-PO7CUR5U.cjs.map
+//# sourceMappingURL=chunk-PO7CUR5U.cjs.map

package/dist/client/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkSPFRDXAF_cjs = require('../chunk-SPFRDXAF.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 chunkSPFRDXAF_cjs.TypedRelyIOClient; }
+  get: function () { return chunk4HTIU5YE_cjs.TypedRelyIOClient; }
 });
 Object.defineProperty(exports, "createClient", {
   enumerable: true,
-  get: function () { return chunkSPFRDXAF_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-B9axQW8s.cjs';
-import '../index-B_rIWO_l.cjs';
-import '../define-content-type-cEGjIwT5.cjs';
-import '../define-schema-DgbJ5Kwn.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-GIfaMlQ7.js';
-import '../index-Cv4tmcrw.js';
-import '../define-content-type-cEGjIwT5.js';
-import '../define-schema-BPj2srgh.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-LGNJIGHL.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-cEGjIwT5.d.cts → define-content-type-ENAod5Ve.d.cts}

@@ -208,6 +208,23 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    '/internal/usage/stops': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Record the Usage Limit stops an edge refused */
+        post: operations['recordUsageStops'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/v1/{contentType}': {
         parameters: {
             query?: never;
@@ -1041,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;
@@ -1094,7 +1111,7 @@ interface components {
         ErrorResponse: {
             error: {
                 /** @enum {string} */
-                code: 'ACCESS_DENIED' | 'CONTENT_INVALID' | 'INTERNAL_ERROR' | 'INVALID_API_KEY' | 'METHOD_NOT_ALLOWED' | 'MISSING_API_KEY' | 'ORGANIZATION_DELETE_BLOCKED' | 'PAYLOAD_TOO_LARGE' | 'PLAN_DOWNGRADE_BLOCKED' | 'PLAN_FEATURE_UNAVAILABLE' | 'RATE_LIMIT_EXCEEDED' | 'READ_ONLY_KEY' | 'REQUEST_INVALID' | 'REQUEST_TIMEOUT' | 'RESOURCE_CONFLICT' | 'RESOURCE_EXPIRED' | 'RESOURCE_NOT_FOUND' | 'REVERIFICATION_REQUIRED' | 'SERVICE_INDETERMINATE' | 'TRANSACTION_ROLLED_BACK' | 'USAGE_QUOTA_EXCEEDED';
+                code: 'ACCESS_DENIED' | 'CONTENT_INVALID' | 'INTERNAL_ERROR' | 'INVALID_API_KEY' | 'METHOD_NOT_ALLOWED' | 'MISSING_API_KEY' | 'ORGANIZATION_DELETE_BLOCKED' | 'PAYLOAD_TOO_LARGE' | 'PLAN_DOWNGRADE_BLOCKED' | 'PLAN_FEATURE_UNAVAILABLE' | 'RATE_LIMIT_EXCEEDED' | 'READ_ONLY_KEY' | 'REQUEST_INVALID' | 'REQUEST_TIMEOUT' | 'RESOURCE_CONFLICT' | 'RESOURCE_EXPIRED' | 'RESOURCE_NOT_FOUND' | 'REVERIFICATION_REQUIRED' | 'SERVICE_INDETERMINATE' | 'TRANSACTION_ROLLED_BACK' | 'USAGE_QUOTA_EXCEEDED' | 'USER_NOT_PROVISIONED';
                 messages: string[];
                 details?: {
                     [key: string]: unknown;
@@ -1337,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
@@ -1390,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.
@@ -1422,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.
@@ -1465,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
@@ -1495,7 +1516,7 @@ interface components {
             id?: string;
             error: {
                 /** @enum {string} */
-                code: 'ACCESS_DENIED' | 'CONTENT_INVALID' | 'INTERNAL_ERROR' | 'INVALID_API_KEY' | 'METHOD_NOT_ALLOWED' | 'MISSING_API_KEY' | 'ORGANIZATION_DELETE_BLOCKED' | 'PAYLOAD_TOO_LARGE' | 'PLAN_DOWNGRADE_BLOCKED' | 'PLAN_FEATURE_UNAVAILABLE' | 'RATE_LIMIT_EXCEEDED' | 'READ_ONLY_KEY' | 'REQUEST_INVALID' | 'REQUEST_TIMEOUT' | 'RESOURCE_CONFLICT' | 'RESOURCE_EXPIRED' | 'RESOURCE_NOT_FOUND' | 'REVERIFICATION_REQUIRED' | 'SERVICE_INDETERMINATE' | 'TRANSACTION_ROLLED_BACK' | 'USAGE_QUOTA_EXCEEDED';
+                code: 'ACCESS_DENIED' | 'CONTENT_INVALID' | 'INTERNAL_ERROR' | 'INVALID_API_KEY' | 'METHOD_NOT_ALLOWED' | 'MISSING_API_KEY' | 'ORGANIZATION_DELETE_BLOCKED' | 'PAYLOAD_TOO_LARGE' | 'PLAN_DOWNGRADE_BLOCKED' | 'PLAN_FEATURE_UNAVAILABLE' | 'RATE_LIMIT_EXCEEDED' | 'READ_ONLY_KEY' | 'REQUEST_INVALID' | 'REQUEST_TIMEOUT' | 'RESOURCE_CONFLICT' | 'RESOURCE_EXPIRED' | 'RESOURCE_NOT_FOUND' | 'REVERIFICATION_REQUIRED' | 'SERVICE_INDETERMINATE' | 'TRANSACTION_ROLLED_BACK' | 'USAGE_QUOTA_EXCEEDED' | 'USER_NOT_PROVISIONED';
                 messages: string[];
                 details?: {
                     [key: string]: unknown;
@@ -2140,6 +2161,65 @@ interface operations {
             };
         };
     };
+    recordUsageStops: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Success. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': {
+                        /** @description The payload itself. */
+                        data: unknown;
+                    };
+                };
+            };
+            /** @description REQUEST_INVALID */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['RefusalRequestInvalid'];
+                };
+            };
+            /** @description ACCESS_DENIED */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['RefusalAccessDenied'];
+                };
+            };
+            /** @description RESOURCE_NOT_FOUND */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['RefusalResourceNotFound'];
+                };
+            };
+            /** @description INTERNAL_ERROR */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['RefusalInternalError'];
+                };
+            };
+        };
+    };
     listEntries: {
         parameters: {
             query?: {
@@ -6753,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;
 }
@@ -7375,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`.
@@ -7432,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[];
@@ -7693,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-cEGjIwT5.d.ts → define-content-type-ENAod5Ve.d.ts}

@@ -208,6 +208,23 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    '/internal/usage/stops': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Record the Usage Limit stops an edge refused */
+        post: operations['recordUsageStops'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/v1/{contentType}': {
         parameters: {
             query?: never;
@@ -1041,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;
@@ -1094,7 +1111,7 @@ interface components {
         ErrorResponse: {
             error: {
                 /** @enum {string} */
-                code: 'ACCESS_DENIED' | 'CONTENT_INVALID' | 'INTERNAL_ERROR' | 'INVALID_API_KEY' | 'METHOD_NOT_ALLOWED' | 'MISSING_API_KEY' | 'ORGANIZATION_DELETE_BLOCKED' | 'PAYLOAD_TOO_LARGE' | 'PLAN_DOWNGRADE_BLOCKED' | 'PLAN_FEATURE_UNAVAILABLE' | 'RATE_LIMIT_EXCEEDED' | 'READ_ONLY_KEY' | 'REQUEST_INVALID' | 'REQUEST_TIMEOUT' | 'RESOURCE_CONFLICT' | 'RESOURCE_EXPIRED' | 'RESOURCE_NOT_FOUND' | 'REVERIFICATION_REQUIRED' | 'SERVICE_INDETERMINATE' | 'TRANSACTION_ROLLED_BACK' | 'USAGE_QUOTA_EXCEEDED';
+                code: 'ACCESS_DENIED' | 'CONTENT_INVALID' | 'INTERNAL_ERROR' | 'INVALID_API_KEY' | 'METHOD_NOT_ALLOWED' | 'MISSING_API_KEY' | 'ORGANIZATION_DELETE_BLOCKED' | 'PAYLOAD_TOO_LARGE' | 'PLAN_DOWNGRADE_BLOCKED' | 'PLAN_FEATURE_UNAVAILABLE' | 'RATE_LIMIT_EXCEEDED' | 'READ_ONLY_KEY' | 'REQUEST_INVALID' | 'REQUEST_TIMEOUT' | 'RESOURCE_CONFLICT' | 'RESOURCE_EXPIRED' | 'RESOURCE_NOT_FOUND' | 'REVERIFICATION_REQUIRED' | 'SERVICE_INDETERMINATE' | 'TRANSACTION_ROLLED_BACK' | 'USAGE_QUOTA_EXCEEDED' | 'USER_NOT_PROVISIONED';
                 messages: string[];
                 details?: {
                     [key: string]: unknown;
@@ -1337,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
@@ -1390,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.
@@ -1422,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.
@@ -1465,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
@@ -1495,7 +1516,7 @@ interface components {
             id?: string;
             error: {
                 /** @enum {string} */
-                code: 'ACCESS_DENIED' | 'CONTENT_INVALID' | 'INTERNAL_ERROR' | 'INVALID_API_KEY' | 'METHOD_NOT_ALLOWED' | 'MISSING_API_KEY' | 'ORGANIZATION_DELETE_BLOCKED' | 'PAYLOAD_TOO_LARGE' | 'PLAN_DOWNGRADE_BLOCKED' | 'PLAN_FEATURE_UNAVAILABLE' | 'RATE_LIMIT_EXCEEDED' | 'READ_ONLY_KEY' | 'REQUEST_INVALID' | 'REQUEST_TIMEOUT' | 'RESOURCE_CONFLICT' | 'RESOURCE_EXPIRED' | 'RESOURCE_NOT_FOUND' | 'REVERIFICATION_REQUIRED' | 'SERVICE_INDETERMINATE' | 'TRANSACTION_ROLLED_BACK' | 'USAGE_QUOTA_EXCEEDED';
+                code: 'ACCESS_DENIED' | 'CONTENT_INVALID' | 'INTERNAL_ERROR' | 'INVALID_API_KEY' | 'METHOD_NOT_ALLOWED' | 'MISSING_API_KEY' | 'ORGANIZATION_DELETE_BLOCKED' | 'PAYLOAD_TOO_LARGE' | 'PLAN_DOWNGRADE_BLOCKED' | 'PLAN_FEATURE_UNAVAILABLE' | 'RATE_LIMIT_EXCEEDED' | 'READ_ONLY_KEY' | 'REQUEST_INVALID' | 'REQUEST_TIMEOUT' | 'RESOURCE_CONFLICT' | 'RESOURCE_EXPIRED' | 'RESOURCE_NOT_FOUND' | 'REVERIFICATION_REQUIRED' | 'SERVICE_INDETERMINATE' | 'TRANSACTION_ROLLED_BACK' | 'USAGE_QUOTA_EXCEEDED' | 'USER_NOT_PROVISIONED';
                 messages: string[];
                 details?: {
                     [key: string]: unknown;
@@ -2140,6 +2161,65 @@ interface operations {
             };
         };
     };
+    recordUsageStops: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Success. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': {
+                        /** @description The payload itself. */
+                        data: unknown;
+                    };
+                };
+            };
+            /** @description REQUEST_INVALID */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['RefusalRequestInvalid'];
+                };
+            };
+            /** @description ACCESS_DENIED */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['RefusalAccessDenied'];
+                };
+            };
+            /** @description RESOURCE_NOT_FOUND */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['RefusalResourceNotFound'];
+                };
+            };
+            /** @description INTERNAL_ERROR */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['RefusalInternalError'];
+                };
+            };
+        };
+    };
     listEntries: {
         parameters: {
             query?: {
@@ -6753,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;
 }
@@ -7375,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`.
@@ -7432,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[];
@@ -7693,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