@relyio/sdk 0.16.0 → 0.17.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @relyio/sdk
 
+## 0.17.0
+
+### Minor Changes
+
+- fb6625a: `content(type).create()` and `update()` answer `_metadata.warnings`: each reference the content type declares `weak` that the write published while the entry it points at is unpublished, as `{ path, code: 'REFERENCE_NOT_PUBLISHED', message }`. Always present, `[]` when there are none; the write is never refused for them. `create()` now returns `CreatedContent<T>`, the entry with that list.
+
+  `singleton(key).update()`, `settings(group).update()` and `settings(group).reset()` answer the same `_metadata.warnings`, beside the `_metadata.brokenLinks` they already carried; they now return `WrittenSingleton<T>` and `WrittenSettingsGroup<T>`. A `batch()` item for any write but a delete carries the list under `data._metadata.warnings` as well.
+
 ## 0.16.0
 
 ### Minor Changes

package/dist/{chunk-RLLZUFDB.cjs → chunk-6E22GYPB.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
 var chunkLSRPMNPT_cjs = require('./chunk-LSRPMNPT.cjs');
-var chunk7BZW6XYJ_cjs = require('./chunk-7BZW6XYJ.cjs');
+var chunk6PTRZP5U_cjs = require('./chunk-6PTRZP5U.cjs');
 var chunkTZL374LS_cjs = require('./chunk-TZL374LS.cjs');
 var chunkMWMSFIWN_cjs = require('./chunk-MWMSFIWN.cjs');
 
@@ -516,7 +516,7 @@ var _ErrorMapper = class _ErrorMapper {
       return new NetworkError(`HTTP ${status}: ${statusText}`.trim(), status, void 0, context);
     }
     const retryAfterMs = parseRetryAfterMs(
-      headerValue(headers, chunk7BZW6XYJ_cjs.HEADER_RETRY_AFTER.name),
+      headerValue(headers, chunk6PTRZP5U_cjs.HEADER_RETRY_AFTER.name),
       Date.now()
     );
     return this.fromContractCode(refusal, status, context, retryAfterMs);
@@ -859,7 +859,7 @@ var IDEMPOTENT_METHODS = /* @__PURE__ */ new Set([
 ]);
 function isReplaySafe(request) {
   if (IDEMPOTENT_METHODS.has(request.method.toUpperCase())) return true;
-  return headerValue(request.headers, chunk7BZW6XYJ_cjs.HEADER_IDEMPOTENCY_KEY.name) !== void 0;
+  return headerValue(request.headers, chunk6PTRZP5U_cjs.HEADER_IDEMPOTENCY_KEY.name) !== void 0;
 }
 chunkMWMSFIWN_cjs.__name(isReplaySafe, "isReplaySafe");
 var UNREACHABLE_CODES = /* @__PURE__ */ new Set(["ECONNREFUSED", "ENOTFOUND"]);
@@ -920,7 +920,7 @@ chunkMWMSFIWN_cjs.__name(isDerivedPreview, "isDerivedPreview");
 function isUnknownPreview(dataset) {
   const since = unknown.get(dataset);
   if (since === void 0) return false;
-  if (Date.now() - since < chunk7BZW6XYJ_cjs.UNKNOWN_PREVIEW_RECHECK_MS) return true;
+  if (Date.now() - since < chunk6PTRZP5U_cjs.UNKNOWN_PREVIEW_RECHECK_MS) return true;
   unknown.delete(dataset);
   return false;
 }
@@ -1453,7 +1453,7 @@ chunkMWMSFIWN_cjs.__name(credentialsModeFor, "credentialsModeFor");
 // src/http/write-options.ts
 function versionCheckOf(entry) {
   const { id, locale, version, sharedVersion } = entry._metadata;
-  return { id, locale, ifMatch: chunk7BZW6XYJ_cjs.entityTag({ entryUid: id, locale, version, sharedVersion }) };
+  return { id, locale, ifMatch: chunk6PTRZP5U_cjs.entityTag({ entryUid: id, locale, version, sharedVersion }) };
 }
 chunkMWMSFIWN_cjs.__name(versionCheckOf, "versionCheckOf");
 function mintIdempotencyKey() {
@@ -1465,11 +1465,11 @@ chunkMWMSFIWN_cjs.__name(mintIdempotencyKey, "mintIdempotencyKey");
 function writeHeaders(options) {
   const headers = {};
   if (options?.ifMatch !== void 0) {
-    headers[chunk7BZW6XYJ_cjs.HEADER_IF_MATCH.name] = options.ifMatch;
+    headers[chunk6PTRZP5U_cjs.HEADER_IF_MATCH.name] = options.ifMatch;
   }
   const idempotencyKey = options?.idempotencyKey ?? mintIdempotencyKey();
   if (idempotencyKey !== void 0) {
-    headers[chunk7BZW6XYJ_cjs.HEADER_IDEMPOTENCY_KEY.name] = idempotencyKey;
+    headers[chunk6PTRZP5U_cjs.HEADER_IDEMPOTENCY_KEY.name] = idempotencyKey;
   }
   return Object.keys(headers).length > 0 ? headers : void 0;
 }
@@ -1566,7 +1566,7 @@ function writeDocumentTerms(query, options, clientLocale) {
     query.include = options.include.join(",");
   }
   writeLocale(query, options.locale ?? clientLocale);
-  if (typeof options.fresh === "string") query[chunk7BZW6XYJ_cjs.FRESH_PARAMETER] = options.fresh;
+  if (typeof options.fresh === "string") query[chunk6PTRZP5U_cjs.FRESH_PARAMETER] = options.fresh;
 }
 chunkMWMSFIWN_cjs.__name(writeDocumentTerms, "writeDocumentTerms");
 function writeLocale(query, locale) {
@@ -1736,7 +1736,10 @@ var EntryHandle = _EntryHandle;
 // src/content/content-client.ts
 var _ContentClient = class _ContentClient extends EntryHandle {
   /**
-   * Create a new content entry.
+   * Create a new content entry, published. The answer's `_metadata.warnings` lists each reference
+   * the content type declares `weak` that the create made live while the entry it points at is
+   * unpublished (`REFERENCE_NOT_PUBLISHED`) — `[]` when there are none; the create is never refused
+   * for them.
    *
    * `locale` defaults to the client's own, and `dataset` to the client's (`client.with({ dataset })`
    * sets it for every call).
@@ -2642,7 +2645,10 @@ var _SingletonClient = class _SingletonClient extends DocumentHandle {
       throw error;
     }
   }
-  /** The API publishes on PATCH: there is no separate publish route. */
+  /**
+   * The API publishes on PATCH: there is no separate publish route. The answer's `_metadata` also
+   * lists the links the write left pointing nowhere and its `warnings` (REL-3097).
+   */
   patch(write, options) {
     return this.httpClient.fetchPayload(
       "/v1/singletons/{key}",
@@ -2702,15 +2708,11 @@ var _SettingsClient = class _SettingsClient extends DocumentHandle {
   async reset(...args) {
     const [first, second] = args;
     const write = first !== void 0 && isRead(first) ? { ...versionCheckOf(first), options: second } : { locale: this.localeOf(first?.locale), ifMatch: void 0, options: first };
-    return this.httpClient.fetchPayload(
-      "/v1/settings/{groupId}/reset",
-      "post",
-      {
-        path: { groupId: this.name },
-        query: write.locale === void 0 ? void 0 : { locale: write.locale },
-        headers: DocumentHandle.headersOf(write, write.options)
-      }
-    );
+    return this.httpClient.fetchPayload("/v1/settings/{groupId}/reset", "post", {
+      path: { groupId: this.name },
+      query: write.locale === void 0 ? void 0 : { locale: write.locale },
+      headers: DocumentHandle.headersOf(write, write.options)
+    });
   }
   /** The group's default values, as the schema declares them. */
   async getDefaults() {
@@ -2959,7 +2961,7 @@ chunkMWMSFIWN_cjs.__name(originOf, "originOf");
 
 // src/changes/live-edge.ts
 var LIVE_KEEPALIVE_INTERVAL_MS = 3e4;
-var LIVE_SOCKET_OPEN_TIMEOUT_MS = chunk7BZW6XYJ_cjs.VISITOR_POLL_INTERVAL_MS;
+var LIVE_SOCKET_OPEN_TIMEOUT_MS = chunk6PTRZP5U_cjs.VISITOR_POLL_INTERVAL_MS;
 var LIVE_POLLS_BEFORE_SOCKET = 4;
 async function* subscribeLiveEdge(client, options = {}) {
   const { signal } = options;
@@ -3029,12 +3031,12 @@ async function* followSocket(socket, reach, options) {
           return "unopened";
         }
         case "message": {
-          if (event.data === chunk7BZW6XYJ_cjs.VISITOR_KEEPALIVE.response) continue;
-          const frame = typeof event.data === "string" ? chunk7BZW6XYJ_cjs.parseVisitorFrame(event.data) : null;
+          if (event.data === chunk6PTRZP5U_cjs.VISITOR_KEEPALIVE.response) continue;
+          const frame = typeof event.data === "string" ? chunk6PTRZP5U_cjs.parseVisitorFrame(event.data) : null;
           if (frame === null)
             throw unreadable(`a frame the wire does not declare: ${sample(event.data)}`);
           switch (frame.type) {
-            case chunk7BZW6XYJ_cjs.VISITOR_FRAMES.opened: {
+            case chunk6PTRZP5U_cjs.VISITOR_FRAMES.opened: {
               caughtUp = true;
               inbox.caughtUp();
               reach.position = frame.cursor;
@@ -3042,7 +3044,7 @@ async function* followSocket(socket, reach, options) {
               options.reached?.(frame.cursor);
               continue;
             }
-            case chunk7BZW6XYJ_cjs.VISITOR_FRAMES.changes: {
+            case chunk6PTRZP5U_cjs.VISITOR_FRAMES.changes: {
               const prior = reach.position;
               if (prior === void 0) throw unreadable("changes before the socket had a position");
               for (const change of changesOf(frame.changes, frame.cursor, prior)) {
@@ -3053,7 +3055,7 @@ async function* followSocket(socket, reach, options) {
               if (frame.changes.length === 0) options.reached?.(frame.cursor);
               continue;
             }
-            case chunk7BZW6XYJ_cjs.VISITOR_FRAMES.resync: {
+            case chunk6PTRZP5U_cjs.VISITOR_FRAMES.resync: {
               await expire(frame.reason, frame.cursor, options);
               if (isAborted(signal)) return "aborted";
               reach.position = frame.cursor;
@@ -3125,7 +3127,7 @@ function socketInbox(socket, signal) {
           return;
         }
         heard = false;
-        if (socket.readyState === SOCKET_OPEN) socket.send(chunk7BZW6XYJ_cjs.VISITOR_KEEPALIVE.request);
+        if (socket.readyState === SOCKET_OPEN) socket.send(chunk6PTRZP5U_cjs.VISITOR_KEEPALIVE.request);
       }, LIVE_KEEPALIVE_INTERVAL_MS);
     },
     caughtUp() {
@@ -3161,19 +3163,19 @@ var AFTER_A_CLOSE = {
   "back-off": "Retrying after a back-off of at least a minute, without polling, which the same admission refuses."
 };
 function closeRetryOf(code) {
-  if (hasOwn(chunk7BZW6XYJ_cjs.VISITOR_CLOSE_RETRY, code)) return chunk7BZW6XYJ_cjs.VISITOR_CLOSE_RETRY[code];
+  if (hasOwn(chunk6PTRZP5U_cjs.VISITOR_CLOSE_RETRY, code)) return chunk6PTRZP5U_cjs.VISITOR_CLOSE_RETRY[code];
   return code < 4e3 ? "retry" : "stop";
 }
 chunkMWMSFIWN_cjs.__name(closeRetryOf, "closeRetryOf");
 var CLOSE_MEANING = {
-  [chunk7BZW6XYJ_cjs.VISITOR_CLOSE_CODES.requestInvalid]: "the edge could not read the request \u2014 a malformed cursor or filter",
-  [chunk7BZW6XYJ_cjs.VISITOR_CLOSE_CODES.keyRefused]: "the key is not a publishable key the edge accepts \u2014 unknown, revoked or expired",
-  [chunk7BZW6XYJ_cjs.VISITOR_CLOSE_CODES.originRefused]: "this page\u2019s origin is not on the publishable key\u2019s allowed origins",
-  [chunk7BZW6XYJ_cjs.VISITOR_CLOSE_CODES.datasetRefused]: "`dataset` names no dataset the key reaches",
-  [chunk7BZW6XYJ_cjs.VISITOR_CLOSE_CODES.unavailable]: "the edge could not serve this connection just now \u2014 it could not reach what it needed",
-  [chunk7BZW6XYJ_cjs.VISITOR_CLOSE_CODES.allowanceReached]: "the project holds as many live connections as its plan allows",
-  [chunk7BZW6XYJ_cjs.VISITOR_CLOSE_CODES.addressLimitReached]: "this address holds as many live connections to the project as one address may",
-  [chunk7BZW6XYJ_cjs.VISITOR_CLOSE_CODES.ceilingReached]: "the project is at its safety ceiling of live connections"
+  [chunk6PTRZP5U_cjs.VISITOR_CLOSE_CODES.requestInvalid]: "the edge could not read the request \u2014 a malformed cursor or filter",
+  [chunk6PTRZP5U_cjs.VISITOR_CLOSE_CODES.keyRefused]: "the key is not a publishable key the edge accepts \u2014 unknown, revoked or expired",
+  [chunk6PTRZP5U_cjs.VISITOR_CLOSE_CODES.originRefused]: "this page\u2019s origin is not on the publishable key\u2019s allowed origins",
+  [chunk6PTRZP5U_cjs.VISITOR_CLOSE_CODES.datasetRefused]: "`dataset` names no dataset the key reaches",
+  [chunk6PTRZP5U_cjs.VISITOR_CLOSE_CODES.unavailable]: "the edge could not serve this connection just now \u2014 it could not reach what it needed",
+  [chunk6PTRZP5U_cjs.VISITOR_CLOSE_CODES.allowanceReached]: "the project holds as many live connections as its plan allows",
+  [chunk6PTRZP5U_cjs.VISITOR_CLOSE_CODES.addressLimitReached]: "this address holds as many live connections to the project as one address may",
+  [chunk6PTRZP5U_cjs.VISITOR_CLOSE_CODES.ceilingReached]: "the project is at its safety ceiling of live connections"
 };
 async function* followPolls(client, request, reach, options) {
   const { signal } = options;
@@ -3201,7 +3203,7 @@ async function* followPolls(client, request, reach, options) {
       if (starting) options.reached?.(answer.cursor);
     }
     starting = false;
-    await sleep(chunk7BZW6XYJ_cjs.VISITOR_POLL_INTERVAL_MS, signal);
+    await sleep(chunk6PTRZP5U_cjs.VISITOR_POLL_INTERVAL_MS, signal);
   }
   return isAborted(signal) ? "aborted" : "socket";
 }
@@ -3243,7 +3245,7 @@ async function pollOnce2(client, request, since, signal) {
     }
     const body = parseJson(text);
     if (!response.ok) throw refusedPoll(response, body, context);
-    const answer = chunk7BZW6XYJ_cjs.readVisitorPollAnswer(isRecord(body) ? body["data"] : void 0);
+    const answer = chunk6PTRZP5U_cjs.readVisitorPollAnswer(isRecord(body) ? body["data"] : void 0);
     if (answer === null)
       throw unreadable(`a poll answer the wire does not declare: ${sample(text)}`);
     return answer;
@@ -3263,13 +3265,13 @@ function refusedPoll(response, body, context) {
     { ...context, method: "GET" }
   );
   const refusal = readError(body);
-  if (refusal === void 0 || !hasOwn(chunk7BZW6XYJ_cjs.VISITOR_POLL_RETRY, refusal.code)) return mapped;
+  if (refusal === void 0 || !hasOwn(chunk6PTRZP5U_cjs.VISITOR_POLL_RETRY, refusal.code)) return mapped;
   const code = refusal.code;
   const retryAfterMs = parseRetryAfterMs(headerValue(headers, "Retry-After"), Date.now());
   return new LiveEdgeError(
     `The live edge refused a poll (${code}): ${refusal.messages[0] ?? mapped.message}`,
     { kind: "refused", code },
-    chunk7BZW6XYJ_cjs.VISITOR_POLL_RETRY[code],
+    chunk6PTRZP5U_cjs.VISITOR_POLL_RETRY[code],
     {
       statusCode: response.status,
       cause: mapped,
@@ -3297,17 +3299,17 @@ function edgeRequest(client, filter) {
 chunkMWMSFIWN_cjs.__name(edgeRequest, "edgeRequest");
 function edgeUrl(request, since, transport, clientId) {
   const url = new URL(request.base.href);
-  url.pathname = `${url.pathname.replace(/\/+$/, "")}${chunk7BZW6XYJ_cjs.VISITOR_LIVE_PATH}`;
+  url.pathname = `${url.pathname.replace(/\/+$/, "")}${chunk6PTRZP5U_cjs.VISITOR_LIVE_PATH}`;
   if (transport === "socket") url.protocol = url.protocol === "http:" ? "ws:" : "wss:";
   const query = new URLSearchParams();
-  if (request.key !== void 0) query.set(chunk7BZW6XYJ_cjs.VISITOR_QUERY.key, request.key);
+  if (request.key !== void 0) query.set(chunk6PTRZP5U_cjs.VISITOR_QUERY.key, request.key);
   if (request.dataset !== void 0 && request.dataset !== "") {
-    query.set(chunk7BZW6XYJ_cjs.VISITOR_QUERY.dataset, request.dataset);
+    query.set(chunk6PTRZP5U_cjs.VISITOR_QUERY.dataset, request.dataset);
   }
-  if (since !== void 0) query.set(chunk7BZW6XYJ_cjs.VISITOR_QUERY.since, since);
-  if (request.types !== void 0) query.set(chunk7BZW6XYJ_cjs.VISITOR_QUERY.types, request.types.join(","));
-  if (request.ids !== void 0) query.set(chunk7BZW6XYJ_cjs.VISITOR_QUERY.ids, request.ids.join(","));
-  if (transport === "poll" && clientId !== void 0) query.set(chunk7BZW6XYJ_cjs.VISITOR_QUERY.client, clientId);
+  if (since !== void 0) query.set(chunk6PTRZP5U_cjs.VISITOR_QUERY.since, since);
+  if (request.types !== void 0) query.set(chunk6PTRZP5U_cjs.VISITOR_QUERY.types, request.types.join(","));
+  if (request.ids !== void 0) query.set(chunk6PTRZP5U_cjs.VISITOR_QUERY.ids, request.ids.join(","));
+  if (transport === "poll" && clientId !== void 0) query.set(chunk6PTRZP5U_cjs.VISITOR_QUERY.client, clientId);
   url.search = query.toString();
   return url.href;
 }
@@ -3394,7 +3396,7 @@ function transportOf(options) {
   return {
     ...signalOf(options),
     ...headers === void 0 ? {} : { headers },
-    ...typeof options.fresh === "string" ? { query: { [chunk7BZW6XYJ_cjs.FRESH_PARAMETER]: options.fresh } } : {}
+    ...typeof options.fresh === "string" ? { query: { [chunk6PTRZP5U_cjs.FRESH_PARAMETER]: options.fresh } } : {}
   };
 }
 chunkMWMSFIWN_cjs.__name(transportOf, "transportOf");
@@ -3575,7 +3577,7 @@ async function runAdhocQuery(http, query, clientLocale) {
   const terms = {};
   if (query.cursor !== void 0) terms.cursor = query.cursor;
   writeLocale(terms, query.locale ?? clientLocale);
-  if (typeof query.fresh === "string") terms[chunk7BZW6XYJ_cjs.FRESH_PARAMETER] = query.fresh;
+  if (typeof query.fresh === "string") terms[chunk6PTRZP5U_cjs.FRESH_PARAMETER] = query.fresh;
   const parameters = { ...query.params };
   const body = {
     query: {
@@ -3610,7 +3612,7 @@ async function runNamedQuery(http, name, options, clientLocale) {
   const locale = options.locale ?? clientLocale;
   const terms = {};
   if (locale !== void 0 && locale !== "") terms.locale = locale;
-  if (typeof options.fresh === "string") terms[chunk7BZW6XYJ_cjs.FRESH_PARAMETER] = options.fresh;
+  if (typeof options.fresh === "string") terms[chunk6PTRZP5U_cjs.FRESH_PARAMETER] = options.fresh;
   const headers = readHeaders(options);
   const response = await http.send(
     "/v1/queries/{name}",
@@ -3731,7 +3733,7 @@ chunkMWMSFIWN_cjs.__name(resolveDevOverride, "resolveDevOverride");
 // src/config/preview-environment.ts
 function readPreviewAtRequest() {
   const env = typeof process === "undefined" ? void 0 : process.env;
-  return chunk7BZW6XYJ_cjs.previewAtRequest(isEnvironment(env) ? env : {});
+  return chunk6PTRZP5U_cjs.previewAtRequest(isEnvironment(env) ? env : {});
 }
 chunkMWMSFIWN_cjs.__name(readPreviewAtRequest, "readPreviewAtRequest");
 function isEnvironment(value) {
@@ -3841,7 +3843,7 @@ function withPreview(configured) {
   if (configured.dataset !== void 0 || !isPreviewKey(configured.apiKey)) return configured;
   const preview = readPreviewAtRequest();
   if (preview.state !== "preview") return configured;
-  const dataset = chunk7BZW6XYJ_cjs.previewDatasetSlug(preview.branch);
+  const dataset = chunk6PTRZP5U_cjs.previewDatasetSlug(preview.branch);
   noteDerivedPreview(dataset);
   if (!previewNotified) {
     previewNotified = true;
@@ -4487,5 +4489,5 @@ exports.serviceInstructedDelayMs = serviceInstructedDelayMs;
 exports.sleep = sleep;
 exports.validateFile = validateFile;
 exports.versionCheckOf = versionCheckOf;
-//# sourceMappingURL=chunk-RLLZUFDB.cjs.map
-//# sourceMappingURL=chunk-RLLZUFDB.cjs.map
+//# sourceMappingURL=chunk-6E22GYPB.cjs.map
+//# sourceMappingURL=chunk-6E22GYPB.cjs.map

package/dist/{chunk-7BZW6XYJ.cjs → chunk-6PTRZP5U.cjs}

@@ -429,5 +429,5 @@ exports.previewAtBuild = previewAtBuild;
 exports.previewAtRequest = previewAtRequest;
 exports.previewDatasetSlug = previewDatasetSlug;
 exports.readVisitorPollAnswer = readVisitorPollAnswer;
-//# sourceMappingURL=chunk-7BZW6XYJ.cjs.map
-//# sourceMappingURL=chunk-7BZW6XYJ.cjs.map
+//# sourceMappingURL=chunk-6PTRZP5U.cjs.map
+//# sourceMappingURL=chunk-6PTRZP5U.cjs.map

package/dist/{chunk-CQHEG7QA.js → chunk-OVMIHAYK.js}

@@ -407,5 +407,5 @@ function hasValue(value) {
 __name(hasValue, "hasValue");
 
 export { FRESH_PARAMETER, HEADER_IDEMPOTENCY_KEY, HEADER_IF_MATCH, HEADER_RETRY_AFTER, PREVIEW_DATASET_PREFIX, UNKNOWN_PREVIEW_RECHECK_MS, VISITOR_ADMISSION_RETRY_AFTER_SECONDS, VISITOR_CLOSE_CODES, VISITOR_CLOSE_RETRY, VISITOR_FRAMES, VISITOR_KEEPALIVE, VISITOR_LIVE_PATH, VISITOR_POLL_INTERVAL_MS, VISITOR_POLL_RETRY, VISITOR_QUERY, entityTag, parseVisitorFrame, previewAtBuild, previewAtRequest, previewDatasetSlug, readVisitorPollAnswer };
-//# sourceMappingURL=chunk-CQHEG7QA.js.map
-//# sourceMappingURL=chunk-CQHEG7QA.js.map
+//# sourceMappingURL=chunk-OVMIHAYK.js.map
+//# sourceMappingURL=chunk-OVMIHAYK.js.map

package/dist/{chunk-NIUOPIIB.js → chunk-VS2DEUTN.js}

@@ -1,5 +1,5 @@
 import { parseDevEnv, DEV_CONTEXT_DIR, DEV_CONTEXT_FILENAME, parseDevContextFile } from './chunk-BBUB7C2Z.js';
-import { VISITOR_CLOSE_CODES, HEADER_RETRY_AFTER, HEADER_IDEMPOTENCY_KEY, UNKNOWN_PREVIEW_RECHECK_MS, entityTag, HEADER_IF_MATCH, FRESH_PARAMETER, VISITOR_KEEPALIVE, parseVisitorFrame, VISITOR_FRAMES, VISITOR_POLL_INTERVAL_MS, VISITOR_CLOSE_RETRY, readVisitorPollAnswer, VISITOR_POLL_RETRY, VISITOR_LIVE_PATH, VISITOR_QUERY, previewAtRequest, previewDatasetSlug } from './chunk-CQHEG7QA.js';
+import { VISITOR_CLOSE_CODES, HEADER_RETRY_AFTER, HEADER_IDEMPOTENCY_KEY, UNKNOWN_PREVIEW_RECHECK_MS, entityTag, HEADER_IF_MATCH, FRESH_PARAMETER, VISITOR_KEEPALIVE, parseVisitorFrame, VISITOR_FRAMES, VISITOR_POLL_INTERVAL_MS, VISITOR_CLOSE_RETRY, readVisitorPollAnswer, VISITOR_POLL_RETRY, VISITOR_LIVE_PATH, VISITOR_QUERY, previewAtRequest, previewDatasetSlug } from './chunk-OVMIHAYK.js';
 import { isBrowser } from './chunk-H6IBQSMM.js';
 import { __name, __publicField } from './chunk-XQ4QHWZE.js';
 
@@ -1734,7 +1734,10 @@ var EntryHandle = _EntryHandle;
 // src/content/content-client.ts
 var _ContentClient = class _ContentClient extends EntryHandle {
   /**
-   * Create a new content entry.
+   * Create a new content entry, published. The answer's `_metadata.warnings` lists each reference
+   * the content type declares `weak` that the create made live while the entry it points at is
+   * unpublished (`REFERENCE_NOT_PUBLISHED`) — `[]` when there are none; the create is never refused
+   * for them.
    *
    * `locale` defaults to the client's own, and `dataset` to the client's (`client.with({ dataset })`
    * sets it for every call).
@@ -2640,7 +2643,10 @@ var _SingletonClient = class _SingletonClient extends DocumentHandle {
       throw error;
     }
   }
-  /** The API publishes on PATCH: there is no separate publish route. */
+  /**
+   * The API publishes on PATCH: there is no separate publish route. The answer's `_metadata` also
+   * lists the links the write left pointing nowhere and its `warnings` (REL-3097).
+   */
   patch(write, options) {
     return this.httpClient.fetchPayload(
       "/v1/singletons/{key}",
@@ -2700,15 +2706,11 @@ var _SettingsClient = class _SettingsClient extends DocumentHandle {
   async reset(...args) {
     const [first, second] = args;
     const write = first !== void 0 && isRead(first) ? { ...versionCheckOf(first), options: second } : { locale: this.localeOf(first?.locale), ifMatch: void 0, options: first };
-    return this.httpClient.fetchPayload(
-      "/v1/settings/{groupId}/reset",
-      "post",
-      {
-        path: { groupId: this.name },
-        query: write.locale === void 0 ? void 0 : { locale: write.locale },
-        headers: DocumentHandle.headersOf(write, write.options)
-      }
-    );
+    return this.httpClient.fetchPayload("/v1/settings/{groupId}/reset", "post", {
+      path: { groupId: this.name },
+      query: write.locale === void 0 ? void 0 : { locale: write.locale },
+      headers: DocumentHandle.headersOf(write, write.options)
+    });
   }
   /** The group's default values, as the schema declares them. */
   async getDefaults() {
@@ -4431,5 +4433,5 @@ function randomClientId() {
 __name(randomClientId, "randomClientId");
 
 export { AssetClient, AssetFileBuilder, AssetUploadBuilder, AuthorizationError, BaseValidationError, ChangesExpiredError, ConnectionError, ContentClient, DefaultRetryPolicy, ErrorMapper, FileUploadError, FileValidationError, HttpClient, InvalidApiKeyError, InvalidPayloadError, LIVE_KEEPALIVE_INTERVAL_MS, LIVE_SOCKET_OPEN_TIMEOUT_MS, LiveEdgeError, MethodNotAllowedError, MissingApiKeyError, NetworkError, PREVIEW_KEY_PREFIX, PUBLISHABLE_KEY_PREFIX, PayloadTooLargeError, PlanFeatureUnavailableError, RateLimitError, ReadOnlyKeyError, ResourceConflictError, ResourceExpiredError, ResourceNotFoundError, SDKError, ServerError, ServiceIndeterminateError, SettingsClient, SingletonClient, TimeoutError, TransactionRolledBackError, TypedRelyIOClient, UnknownContractError, UsageQuotaExceededError, ValidationError, createClient, isAborted, isAssetEntry, isMissingEntry, isPreviewKey, isPublishableKey, isReplaySafe, isResourceNotFound, matchRoute, retryPolicyFor, serviceInstructedDelayMs, sleep, validateFile, versionCheckOf };
-//# sourceMappingURL=chunk-NIUOPIIB.js.map
-//# sourceMappingURL=chunk-NIUOPIIB.js.map
+//# sourceMappingURL=chunk-VS2DEUTN.js.map
+//# sourceMappingURL=chunk-VS2DEUTN.js.map

package/dist/client/index.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunkRLLZUFDB_cjs = require('../chunk-RLLZUFDB.cjs');
+var chunk6E22GYPB_cjs = require('../chunk-6E22GYPB.cjs');
 require('../chunk-LSRPMNPT.cjs');
-require('../chunk-7BZW6XYJ.cjs');
+require('../chunk-6PTRZP5U.cjs');
 require('../chunk-TZL374LS.cjs');
 require('../chunk-MWMSFIWN.cjs');
 
@@ -10,11 +10,11 @@ require('../chunk-MWMSFIWN.cjs');
 
 Object.defineProperty(exports, "TypedRelyIOClient", {
   enumerable: true,
-  get: function () { return chunkRLLZUFDB_cjs.TypedRelyIOClient; }
+  get: function () { return chunk6E22GYPB_cjs.TypedRelyIOClient; }
 });
 Object.defineProperty(exports, "createClient", {
   enumerable: true,
-  get: function () { return chunkRLLZUFDB_cjs.createClient; }
+  get: function () { return chunk6E22GYPB_cjs.createClient; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/client/index.d.cts

@@ -1,5 +1,5 @@
-export { e as ClientDefaults, f as ClientSchema, R as Register, h as RegisteredSchema, d as TypedClientConfig, T as TypedRelyIOClient, c as createClient } from '../index-D80MXUkf.cjs';
-import '../define-content-type-LkI0rS2W.cjs';
+export { e as ClientDefaults, f as ClientSchema, R as Register, h as RegisteredSchema, d as TypedClientConfig, T as TypedRelyIOClient, c as createClient } from '../index-DxRmKPrR.cjs';
+import '../define-content-type-AuL9-oz6.cjs';
 import '../rich-text.d-BWc-5gX1.cjs';
-import '../define-schema-wlsJOrnY.cjs';
+import '../define-schema-DkXwpp0I.cjs';
 import '../dev-handshake/index.cjs';

package/dist/client/index.d.ts

@@ -1,5 +1,5 @@
-export { e as ClientDefaults, f as ClientSchema, R as Register, h as RegisteredSchema, d as TypedClientConfig, T as TypedRelyIOClient, c as createClient } from '../index-BH8JksfG.js';
-import '../define-content-type-CAWSlgn0.js';
+export { e as ClientDefaults, f as ClientSchema, R as Register, h as RegisteredSchema, d as TypedClientConfig, T as TypedRelyIOClient, c as createClient } from '../index-BBp8_tn9.js';
+import '../define-content-type-BGoQxqLf.js';
 import '../rich-text.d-BWc-5gX1.js';
-import '../define-schema-Dxu3RoHV.js';
+import '../define-schema-DgCX9YB7.js';
 import '../dev-handshake/index.js';

package/dist/client/index.js

@@ -1,6 +1,6 @@
-export { TypedRelyIOClient, createClient } from '../chunk-NIUOPIIB.js';
+export { TypedRelyIOClient, createClient } from '../chunk-VS2DEUTN.js';
 import '../chunk-BBUB7C2Z.js';
-import '../chunk-CQHEG7QA.js';
+import '../chunk-OVMIHAYK.js';
 import '../chunk-H6IBQSMM.js';
 import '../chunk-XQ4QHWZE.js';
 //# sourceMappingURL=index.js.map