@relyio/sdk 0.8.0 → 0.10.0

package/dist/{chunk-72UK5U7T.cjs → chunk-2HP566NI.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-2HP566NI.cjs.map
+//# sourceMappingURL=chunk-2HP566NI.cjs.map

package/dist/{chunk-QFHVF3YF.js → chunk-2L5JUW7O.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,
@@ -4862,6 +4873,7 @@ async function* pollChanges(http, options = {}) {
   const { signal } = options;
   let since = options.since;
   let resynced;
+  let starting = since === void 0;
   for (; ; ) {
     if (isAborted(signal)) return;
     let response;
@@ -4892,6 +4904,10 @@ async function* pollChanges(http, options = {}) {
       yield { ...change, fresh: change.cursor };
       if (isAborted(signal)) return;
     }
+    if (starting) {
+      starting = false;
+      options.reached?.(page.nextCursor);
+    }
     if (data.length === 0) {
       const wait = parseRetryAfterMs(headerValue(response.headers, "Retry-After"), Date.now());
       if (wait !== void 0 && wait > 0) await sleep(wait, signal);
@@ -5019,23 +5035,12 @@ __name(originOf, "originOf");
 
 // src/changes/live-edge.ts
 var LIVE_KEEPALIVE_INTERVAL_MS = 3e4;
+var LIVE_SOCKET_OPEN_TIMEOUT_MS = VISITOR_POLL_INTERVAL_MS;
 var LIVE_POLLS_BEFORE_SOCKET = 4;
 async function* subscribeLiveEdge(client, options = {}) {
   const { signal } = options;
   if (isAborted(signal)) return;
-  const key = client.apiKey;
-  if (key === void 0 || !isPublishableKey(key)) {
-    throw new LiveEdgeError(NEEDS_PUBLISHABLE_KEY, { kind: "needs-publishable-key" }, "stop");
-  }
-  const address = liveEdgeAddress(client);
-  if (!address.ok) throw new LiveEdgeError(address.message, { kind: "needs-live-url" }, "stop");
-  const request = {
-    base: address.url,
-    key,
-    dataset: client.dataset,
-    types: options.types,
-    ids: options.ids
-  };
+  const request = edgeRequest(client, options);
   const reach = { position: options.since };
   for (; ; ) {
     const socket = openSocket(client, edgeUrl(request, reach.position, "socket"));
@@ -5069,6 +5074,7 @@ async function* followSocket(socket, reach, options) {
   const { signal } = options;
   const inbox = socketInbox(socket, signal);
   let open = false;
+  let caughtUp = false;
   try {
     for (; ; ) {
       const event = await inbox.next();
@@ -5094,6 +5100,10 @@ async function* followSocket(socket, reach, options) {
             "retry"
           );
         }
+        case "late": {
+          if (caughtUp) continue;
+          return "unopened";
+        }
         case "message": {
           if (event.data === VISITOR_KEEPALIVE.response) continue;
           const frame = typeof event.data === "string" ? parseVisitorFrame(event.data) : null;
@@ -5101,6 +5111,8 @@ async function* followSocket(socket, reach, options) {
             throw unreadable(`a frame the wire does not declare: ${sample(event.data)}`);
           switch (frame.type) {
             case VISITOR_FRAMES.opened: {
+              caughtUp = true;
+              inbox.caughtUp();
               reach.position = frame.cursor;
               options.opened?.();
               options.reached?.(frame.cursor);
@@ -5167,6 +5179,10 @@ function socketInbox(socket, signal) {
   });
   socket.addEventListener("error", () => push({ kind: "error" }));
   signal?.addEventListener("abort", rouse, { once: true });
+  let connecting = setTimeout(() => {
+    connecting = void 0;
+    push({ kind: "late" });
+  }, LIVE_SOCKET_OPEN_TIMEOUT_MS);
   return {
     async next() {
       for (; ; ) {
@@ -5188,8 +5204,13 @@ function socketInbox(socket, signal) {
         if (socket.readyState === SOCKET_OPEN) socket.send(VISITOR_KEEPALIVE.request);
       }, LIVE_KEEPALIVE_INTERVAL_MS);
     },
+    caughtUp() {
+      if (connecting !== void 0) clearTimeout(connecting);
+      connecting = void 0;
+    },
     dispose() {
       disposed = true;
+      if (connecting !== void 0) clearTimeout(connecting);
       if (keepalive !== void 0) clearInterval(keepalive);
       signal?.removeEventListener("abort", rouse);
       if (socket.readyState === SOCKET_CONNECTING || socket.readyState === SOCKET_OPEN) {
@@ -5225,7 +5246,9 @@ var CLOSE_MEANING = {
   [VISITOR_CLOSE_CODES.keyRefused]: "the key is not a publishable key the edge accepts \u2014 unknown, revoked or expired",
   [VISITOR_CLOSE_CODES.originRefused]: "this page\u2019s origin is not on the publishable key\u2019s allowed origins",
   [VISITOR_CLOSE_CODES.datasetRefused]: "`dataset` names no dataset the key reaches",
-  [VISITOR_CLOSE_CODES.unavailable]: "the edge could not reach what it needed to decide just now",
+  // Also how the edge hands a connection on when the project's live objects move to another
+  // placement (reason `moved`, REL-1514): either way the same request succeeds again shortly.
+  [VISITOR_CLOSE_CODES.unavailable]: "the edge could not serve this connection just now \u2014 it could not reach what it needed, or it moved the project\u2019s live connections elsewhere",
   [VISITOR_CLOSE_CODES.allowanceReached]: "the project holds as many live connections as its plan allows",
   [VISITOR_CLOSE_CODES.addressLimitReached]: "this address holds as many live connections to the project as one address may",
   [VISITOR_CLOSE_CODES.ceilingReached]: "the project is at its safety ceiling of live connections"
@@ -5332,6 +5355,22 @@ function refusedPoll(response, body, context) {
   );
 }
 __name(refusedPoll, "refusedPoll");
+function edgeRequest(client, filter) {
+  const key = client.apiKey;
+  if (key === void 0 || !isPublishableKey(key)) {
+    throw new LiveEdgeError(NEEDS_PUBLISHABLE_KEY, { kind: "needs-publishable-key" }, "stop");
+  }
+  const address = liveEdgeAddress(client);
+  if (!address.ok) throw new LiveEdgeError(address.message, { kind: "needs-live-url" }, "stop");
+  return {
+    base: address.url,
+    key,
+    dataset: client.dataset,
+    types: filter.types,
+    ids: filter.ids
+  };
+}
+__name(edgeRequest, "edgeRequest");
 function edgeUrl(request, since, transport, clientId) {
   const url = new URL(request.base.href);
   url.pathname = `${url.pathname.replace(/\/+$/, "")}${VISITOR_LIVE_PATH}`;
@@ -5892,9 +5931,14 @@ var _TypedRelyIOClient = class _TypedRelyIOClient {
    * (`rly_pub_…`): each change as ids, in order — the transport a browser follows changes with.
    *
    * A WebSocket to the edge, from `since` or the dataset's current position; where a socket cannot
-   * open — the runtime has none, or the network refuses it — it polls the edge instead, about every
-   * fifteen seconds, from the same cursor. The edge is `liveUrl`, or derived from the default
-   * `baseUrl` (see `RelyIOConfig.liveUrl`).
+   * open — the runtime has none, the network refuses it, or it has not opened and been told its
+   * position within `LIVE_SOCKET_OPEN_TIMEOUT_MS` — it polls the edge instead, about every fifteen
+   * seconds, from the same cursor. The edge is `liveUrl`, or derived from the default `baseUrl`
+   * (see `RelyIOConfig.liveUrl`).
+   *
+   * Without `since` it starts at the dataset's current position, which it hands `reached` before
+   * anything after it: read what you show after that call, and a publish your read did not see is
+   * one this subscription announces (see `LiveChangesOptions.since`).
    *
    * One subscription ends only when `signal` aborts, which ends the `for await` cleanly; every other
    * end — a socket a deploy dropped, a refusal, a refused poll — is thrown as a `LiveEdgeError`
@@ -6240,6 +6284,6 @@ 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, 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-QFHVF3YF.js.map
-//# sourceMappingURL=chunk-QFHVF3YF.js.map
+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

package/dist/{chunk-XIE7WJV3.cjs → chunk-DC4QLAI3.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,
@@ -4864,6 +4875,7 @@ async function* pollChanges(http, options = {}) {
   const { signal } = options;
   let since = options.since;
   let resynced;
+  let starting = since === void 0;
   for (; ; ) {
     if (isAborted(signal)) return;
     let response;
@@ -4894,6 +4906,10 @@ async function* pollChanges(http, options = {}) {
       yield { ...change, fresh: change.cursor };
       if (isAborted(signal)) return;
     }
+    if (starting) {
+      starting = false;
+      options.reached?.(page.nextCursor);
+    }
     if (data.length === 0) {
       const wait = parseRetryAfterMs(headerValue(response.headers, "Retry-After"), Date.now());
       if (wait !== void 0 && wait > 0) await sleep(wait, signal);
@@ -5021,23 +5037,12 @@ chunkMWMSFIWN_cjs.__name(originOf, "originOf");
 
 // src/changes/live-edge.ts
 var LIVE_KEEPALIVE_INTERVAL_MS = 3e4;
+var LIVE_SOCKET_OPEN_TIMEOUT_MS = VISITOR_POLL_INTERVAL_MS;
 var LIVE_POLLS_BEFORE_SOCKET = 4;
 async function* subscribeLiveEdge(client, options = {}) {
   const { signal } = options;
   if (isAborted(signal)) return;
-  const key = client.apiKey;
-  if (key === void 0 || !isPublishableKey(key)) {
-    throw new LiveEdgeError(NEEDS_PUBLISHABLE_KEY, { kind: "needs-publishable-key" }, "stop");
-  }
-  const address = liveEdgeAddress(client);
-  if (!address.ok) throw new LiveEdgeError(address.message, { kind: "needs-live-url" }, "stop");
-  const request = {
-    base: address.url,
-    key,
-    dataset: client.dataset,
-    types: options.types,
-    ids: options.ids
-  };
+  const request = edgeRequest(client, options);
   const reach = { position: options.since };
   for (; ; ) {
     const socket = openSocket(client, edgeUrl(request, reach.position, "socket"));
@@ -5071,6 +5076,7 @@ async function* followSocket(socket, reach, options) {
   const { signal } = options;
   const inbox = socketInbox(socket, signal);
   let open = false;
+  let caughtUp = false;
   try {
     for (; ; ) {
       const event = await inbox.next();
@@ -5096,6 +5102,10 @@ async function* followSocket(socket, reach, options) {
             "retry"
           );
         }
+        case "late": {
+          if (caughtUp) continue;
+          return "unopened";
+        }
         case "message": {
           if (event.data === VISITOR_KEEPALIVE.response) continue;
           const frame = typeof event.data === "string" ? parseVisitorFrame(event.data) : null;
@@ -5103,6 +5113,8 @@ async function* followSocket(socket, reach, options) {
             throw unreadable(`a frame the wire does not declare: ${sample(event.data)}`);
           switch (frame.type) {
             case VISITOR_FRAMES.opened: {
+              caughtUp = true;
+              inbox.caughtUp();
               reach.position = frame.cursor;
               options.opened?.();
               options.reached?.(frame.cursor);
@@ -5169,6 +5181,10 @@ function socketInbox(socket, signal) {
   });
   socket.addEventListener("error", () => push({ kind: "error" }));
   signal?.addEventListener("abort", rouse, { once: true });
+  let connecting = setTimeout(() => {
+    connecting = void 0;
+    push({ kind: "late" });
+  }, LIVE_SOCKET_OPEN_TIMEOUT_MS);
   return {
     async next() {
       for (; ; ) {
@@ -5190,8 +5206,13 @@ function socketInbox(socket, signal) {
         if (socket.readyState === SOCKET_OPEN) socket.send(VISITOR_KEEPALIVE.request);
       }, LIVE_KEEPALIVE_INTERVAL_MS);
     },
+    caughtUp() {
+      if (connecting !== void 0) clearTimeout(connecting);
+      connecting = void 0;
+    },
     dispose() {
       disposed = true;
+      if (connecting !== void 0) clearTimeout(connecting);
       if (keepalive !== void 0) clearInterval(keepalive);
       signal?.removeEventListener("abort", rouse);
       if (socket.readyState === SOCKET_CONNECTING || socket.readyState === SOCKET_OPEN) {
@@ -5227,7 +5248,9 @@ var CLOSE_MEANING = {
   [VISITOR_CLOSE_CODES.keyRefused]: "the key is not a publishable key the edge accepts \u2014 unknown, revoked or expired",
   [VISITOR_CLOSE_CODES.originRefused]: "this page\u2019s origin is not on the publishable key\u2019s allowed origins",
   [VISITOR_CLOSE_CODES.datasetRefused]: "`dataset` names no dataset the key reaches",
-  [VISITOR_CLOSE_CODES.unavailable]: "the edge could not reach what it needed to decide just now",
+  // Also how the edge hands a connection on when the project's live objects move to another
+  // placement (reason `moved`, REL-1514): either way the same request succeeds again shortly.
+  [VISITOR_CLOSE_CODES.unavailable]: "the edge could not serve this connection just now \u2014 it could not reach what it needed, or it moved the project\u2019s live connections elsewhere",
   [VISITOR_CLOSE_CODES.allowanceReached]: "the project holds as many live connections as its plan allows",
   [VISITOR_CLOSE_CODES.addressLimitReached]: "this address holds as many live connections to the project as one address may",
   [VISITOR_CLOSE_CODES.ceilingReached]: "the project is at its safety ceiling of live connections"
@@ -5334,6 +5357,22 @@ function refusedPoll(response, body, context) {
   );
 }
 chunkMWMSFIWN_cjs.__name(refusedPoll, "refusedPoll");
+function edgeRequest(client, filter) {
+  const key = client.apiKey;
+  if (key === void 0 || !isPublishableKey(key)) {
+    throw new LiveEdgeError(NEEDS_PUBLISHABLE_KEY, { kind: "needs-publishable-key" }, "stop");
+  }
+  const address = liveEdgeAddress(client);
+  if (!address.ok) throw new LiveEdgeError(address.message, { kind: "needs-live-url" }, "stop");
+  return {
+    base: address.url,
+    key,
+    dataset: client.dataset,
+    types: filter.types,
+    ids: filter.ids
+  };
+}
+chunkMWMSFIWN_cjs.__name(edgeRequest, "edgeRequest");
 function edgeUrl(request, since, transport, clientId) {
   const url = new URL(request.base.href);
   url.pathname = `${url.pathname.replace(/\/+$/, "")}${VISITOR_LIVE_PATH}`;
@@ -5894,9 +5933,14 @@ var _TypedRelyIOClient = class _TypedRelyIOClient {
    * (`rly_pub_…`): each change as ids, in order — the transport a browser follows changes with.
    *
    * A WebSocket to the edge, from `since` or the dataset's current position; where a socket cannot
-   * open — the runtime has none, or the network refuses it — it polls the edge instead, about every
-   * fifteen seconds, from the same cursor. The edge is `liveUrl`, or derived from the default
-   * `baseUrl` (see `RelyIOConfig.liveUrl`).
+   * open — the runtime has none, the network refuses it, or it has not opened and been told its
+   * position within `LIVE_SOCKET_OPEN_TIMEOUT_MS` — it polls the edge instead, about every fifteen
+   * seconds, from the same cursor. The edge is `liveUrl`, or derived from the default `baseUrl`
+   * (see `RelyIOConfig.liveUrl`).
+   *
+   * Without `since` it starts at the dataset's current position, which it hands `reached` before
+   * anything after it: read what you show after that call, and a publish your read did not see is
+   * one this subscription announces (see `LiveChangesOptions.since`).
    *
    * One subscription ends only when `signal` aborts, which ends the `for await` cleanly; every other
    * end — a socket a deploy dropped, a refusal, a refused poll — is thrown as a `LiveEdgeError`
@@ -6264,6 +6308,7 @@ exports.HttpClient = HttpClient;
 exports.InvalidApiKeyError = InvalidApiKeyError;
 exports.InvalidPayloadError = InvalidPayloadError;
 exports.LIVE_KEEPALIVE_INTERVAL_MS = LIVE_KEEPALIVE_INTERVAL_MS;
+exports.LIVE_SOCKET_OPEN_TIMEOUT_MS = LIVE_SOCKET_OPEN_TIMEOUT_MS;
 exports.LiveEdgeError = LiveEdgeError;
 exports.MethodNotAllowedError = MethodNotAllowedError;
 exports.MissingApiKeyError = MissingApiKeyError;
@@ -6301,5 +6346,5 @@ exports.matchRoute = matchRoute;
 exports.serviceInstructedDelayMs = serviceInstructedDelayMs;
 exports.sleep = sleep;
 exports.validateFile = validateFile;
-//# sourceMappingURL=chunk-XIE7WJV3.cjs.map
-//# sourceMappingURL=chunk-XIE7WJV3.cjs.map
+//# sourceMappingURL=chunk-DC4QLAI3.cjs.map
+//# sourceMappingURL=chunk-DC4QLAI3.cjs.map

package/dist/{chunk-YEJUMW4X.js → chunk-IGHYC2WM.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-IGHYC2WM.js.map
+//# sourceMappingURL=chunk-IGHYC2WM.js.map

package/dist/client/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkXIE7WJV3_cjs = require('../chunk-XIE7WJV3.cjs');
+var chunkDC4QLAI3_cjs = require('../chunk-DC4QLAI3.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 chunkXIE7WJV3_cjs.TypedRelyIOClient; }
+  get: function () { return chunkDC4QLAI3_cjs.TypedRelyIOClient; }
 });
 Object.defineProperty(exports, "createClient", {
   enumerable: true,
-  get: function () { return chunkXIE7WJV3_cjs.createClient; }
+  get: function () { return chunkDC4QLAI3_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-DBoPPlT1.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-KuYgc7eG.cjs';
+import '../index-NnLCwSqF.cjs';
+import '../define-content-type-DfnTu26S.cjs';
+import '../define-schema-W-0u1Jg1.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-yRJ2IqM_.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-rLEBSFvK.js';
+import '../index-B9hDmCho.js';
+import '../define-content-type-DfnTu26S.js';
+import '../define-schema-rbTrXxNN.js';
 import './live-visitor.js';
 import '../dev-handshake/index.js';

package/dist/client/index.js

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

package/dist/{define-content-type-cEGjIwT5.d.cts → define-content-type-DfnTu26S.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;
@@ -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;
@@ -1495,7 +1512,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 +2157,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?: {