@onlyworlds/sdk 4.35.0 → 4.36.1

package/CHANGELOG.md

@@ -5,6 +5,18 @@ earlier history lives in git log only.
 
 ## [Unreleased]
 
+## [4.36.1] - 2026-10-20
+
+### Changed
+
+- The reset rule in `isResyncRequired`'s and `changes`' doc comments: on a 409 `resync_required`, walk from zero and keep what the local copy holds that the new walk does not name; a reset never empties a copy. It said replace. Keel says keep since PR 104 (the Captain's ruling, 2026-10-20: sharing is forward-only). No code change.
+
+## [4.36.0] - 2026-10-20
+
+### Changed
+
+- **`fieldLabel`** keeps a word written all in capitals as written (`STR` reads "STR", `plan_B` "Plan B"), so a custom stat block reads the same in every tool (Temper, h63 #8197; Lantern and Atlas both call it). Schema field names are all lowercase, so no schema label changes.
+
 ## [4.35.0] - 2026-10-20
 
 ### Added

package/dist/index.d.ts

@@ -2627,8 +2627,9 @@ declare class OwApiError extends Error {
     /**
      * `/changes` refused the cursor (409 `resync_required`): a guest's view of the world
      * changed, or the key's role did (a guest's cursor has another shape). Drop the stored
-     * cursor, walk again from the start, and REPLACE the local copy rather than merging into
-     * it: a guest never receives delete ops, so only the replace removes what it no longer sees.
+     * cursor, walk again from the start, and keep what the local copy holds that the new walk
+     * does not name: a reset never empties a copy (keel PR 104, the Captain's ruling: sharing
+     * is forward-only).
      */
     get isResyncRequired(): boolean;
     /** keel's admission control turned the request away (503 `server_busy`); see retryAfter. */
@@ -2889,8 +2890,8 @@ declare class OwV2Client {
      * another shape than everyone else's).
      * Zero/absent cursor = full export (byte-aligned with the Folder Format).
      * Reset rule: a 409 `resync_required` (err.isResyncRequired) means the key's
-     * view changed (a guest's, or its role): drop the cursor, walk from zero, and
-     * replace the local copy rather than merging into it.
+     * view changed (a guest's, or its role): drop the cursor, walk from zero, and keep what the
+     * local copy holds that the new walk does not name (keel's own words; sharing is forward-only).
      * Citizenship: heaviest route on the platform; default page size is polite.
      * keel sends the cursor of a page at the head as a number (an empty page, for anyone
      * but a guest); it is handed back as a string, like every cursor here.
@@ -3348,7 +3349,10 @@ declare const FIELD_ACRONYMS: readonly string[];
 /**
  * A field name as a label: split on `_`, the first word capitalised, every other word
  * lowercase, an acronym in capitals wherever it falls ("image_url" → "Image URL",
- * "url" → "URL", "time_range_current" → "Time range current").
+ * "url" → "URL", "time_range_current" → "Time range current"). A word written all in
+ * capitals stays as written: a custom field named `STR` reads "STR"
+ * (Lantern's stat blocks; Temper, h63 #8197). Every schema field name is lowercase, so this
+ * reaches only names a person or tool chose.
  *
  * The name is taken as given: a tool that hides an extension prefix (`atlas_`, `x_`,
  * `shadow_`) drops it before calling this.

package/dist/index.js

@@ -105,8 +105,9 @@ var OwApiError = class extends Error {
   /**
    * `/changes` refused the cursor (409 `resync_required`): a guest's view of the world
    * changed, or the key's role did (a guest's cursor has another shape). Drop the stored
-   * cursor, walk again from the start, and REPLACE the local copy rather than merging into
-   * it: a guest never receives delete ops, so only the replace removes what it no longer sees.
+   * cursor, walk again from the start, and keep what the local copy holds that the new walk
+   * does not name: a reset never empties a copy (keel PR 104, the Captain's ruling: sharing
+   * is forward-only).
    */
   get isResyncRequired() {
     return this.status === 409 && this.code === "resync_required";
@@ -457,8 +458,8 @@ var OwV2Client = class {
    * another shape than everyone else's).
    * Zero/absent cursor = full export (byte-aligned with the Folder Format).
    * Reset rule: a 409 `resync_required` (err.isResyncRequired) means the key's
-   * view changed (a guest's, or its role): drop the cursor, walk from zero, and
-   * replace the local copy rather than merging into it.
+   * view changed (a guest's, or its role): drop the cursor, walk from zero, and keep what the
+   * local copy holds that the new walk does not name (keel's own words; sharing is forward-only).
    * Citizenship: heaviest route on the platform; default page size is polite.
    * keel sends the cursor of a page at the head as a number (an empty page, for anyone
    * but a guest); it is handed back as a string, like every cursor here.
@@ -2021,6 +2022,7 @@ function fieldLabel(name) {
   return name.split("_").map((word, i) => {
     const lower = word.toLowerCase();
     if (ACRONYM_SET.has(lower)) return lower.toUpperCase();
+    if (/[A-Z]/.test(word) && word === word.toUpperCase()) return word;
     return i === 0 ? lower.charAt(0).toUpperCase() + lower.slice(1) : lower;
   }).join(" ");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onlyworlds/sdk",
-  "version": "4.35.0",
+  "version": "4.36.1",
   "description": "TypeScript SDK for the OnlyWorlds API - build world-building applications with type safety",
   "type": "module",
   "exports": {