@onlyworlds/sdk 4.52.0 → 4.53.1

package/AGENTS.md

@@ -1,6 +1,6 @@
 # For AI agents using @onlyworlds/sdk
 
-**Current as of**: SDK **4.x** · schema-dist **v0.32.2-dist.37** (canonical 00.32.02).
+**Current as of**: SDK **4.x** · schema-dist **v0.32.2-dist.41** (canonical 00.32.02).
 This line is asserted by `codegen:check` in CI — if the pin moves and this file is not
 re-read against it, the check fails rather than letting this document rot quietly.
 

package/CHANGELOG.md

@@ -5,6 +5,18 @@ earlier history lives in git log only.
 
 ## [Unreleased]
 
+## [4.53.1] - 2026-10-22
+
+### Changed
+
+- **Schema repinned to schema-dist v0.32.2-dist.41** (same canonical 00.32.02; the dist now carries the `.owworld` conformance set at `fixtures/owworld/`, 80 cases, with `verdicts.json` and `CaseFolding-15.1.0.txt`, and its folder lint names a `world.json` with an `api` block that git tracks; no schema file moved). The set's two newest cases are `fail-OW-14-crc`, an entry whose bytes fail the CRC its headers declare, and `fail-OW-14-stored-short`, a stored entry holding fewer bytes than it declares. The reader already refused both as `not_openable`, naming the entry, and needed no change. The world-file conformance test reads the set from the vendored dist, so it runs in CI too, where it used to skip; it also checks that every zip on disk has a verdict. The fold table's test and generator read the dist's `CaseFolding-15.1.0.txt`, the same file the SDK held, and the table is unchanged. Folder spec §4.7 is RULED (v0.3.13). Nothing in the published package changes but its version and these documents: `codegen/` does not ship.
+
+## [4.53.0] - 2026-10-22
+
+### Changed
+
+- **The last seven options objects refuse an unknown key** too: `patch` and `editLinks` (`ifMatch`; the edit itself is `{add, remove}`), `uploadImage`, `createFileTicket`, `uploadFile`, `createWorldLink` and `createSeat`. With 4.51.0 and 4.52.0 every method of the client that takes an object now names a stray key before anything is sent; a client that drops a key it does not know has no place left.
+
 ## [4.52.0] - 2026-10-22
 
 ### Changed

package/SCHEMA.md

@@ -1,6 +1,6 @@
 # OnlyWorlds Schema Reference
 
-**Source**: https://github.com/OnlyWorlds/schema-dist @ **v0.32.2-dist.37** — canonical schema **00.32.02**, published 2026-10-21.
+**Source**: https://github.com/OnlyWorlds/schema-dist @ **v0.32.2-dist.41** — canonical schema **00.32.02**, published 2026-10-22.
 
 GENERATED from the canonical schema YAML — do not hand-edit (regenerate: `python codegen/generate_types.py`).
 Written for both humans and AI agents reading this package locally.

package/dist/index.js

@@ -673,6 +673,7 @@ var OwV2Client = class {
    * it for today's unconditional write.
    */
   async patch(type, id, partial, opts = {}) {
+    only("patch", opts, ["ifMatch"]);
     refuseKnownOf(partial, "patch");
     return this.request("PATCH", `/${type}/${id}/`, { write: true, body: sanitizePayload(partial), ifMatch: opts.ifMatch });
   }
@@ -692,6 +693,8 @@ var OwV2Client = class {
    * moves the element too.
    */
   async editLinks(type, id, field, edit, opts = {}) {
+    only("editLinks", opts, ["ifMatch"]);
+    only("editLinks", edit, ["add", "remove"], "The edit is { add?: string[], remove?: string[] }.");
     return this.request("POST", `/${type}/${id}/links/${field}`, { write: true, body: edit, ifMatch: opts.ifMatch });
   }
   /**
@@ -841,6 +844,7 @@ var OwV2Client = class {
    * needs a new one.
    */
   async uploadImage(image, opts = {}) {
+    only("uploadImage", opts, ["key", "ticket"]);
     const ticket = opts.ticket ?? await this.createMediaTicket();
     const size = typeof Blob !== "undefined" && image instanceof Blob ? image.size : image.byteLength;
     if (size > ticket.max_bytes) {
@@ -944,6 +948,7 @@ var OwV2Client = class {
    * `retryAfter`; 503 `media_unavailable`.
    */
   async createFileTicket(type, id, req) {
+    only("createFileTicket", req, ["name", "kind", "size", "label"]);
     const { name, size } = req;
     if (typeof name !== "string" || name.trim() === "") {
       throw new TypeError("createFileTicket needs the file's name, with its extension");
@@ -984,6 +989,7 @@ var OwV2Client = class {
    * upload succeeds: another file needs a new one.
    */
   async uploadFile(type, id, file, opts = {}) {
+    only("uploadFile", opts, ["name", "kind", "label", "ticket", "onProgress"]);
     const size = typeof Blob !== "undefined" && file instanceof Blob ? file.size : file.byteLength;
     let ticket = opts.ticket;
     if (!ticket) {
@@ -1249,6 +1255,7 @@ var OwV2Client = class {
    * `not_found` (`err.isNotFound`). A world key is a TypeError before anything is sent.
    */
   async createWorldLink(worldId, opts) {
+    only("createWorldLink", opts, ["reader", "role", "days", "inviterName", "withCharacter", "character", "preview", "maxUses", "characters"]);
     if (this.keyKind !== "account") {
       throw new TypeError("createWorldLink needs an account token (ow_a_): only the world's owner makes links");
     }
@@ -1300,6 +1307,7 @@ var OwV2Client = class {
    * its key: rekeySeat gives it a new one (or removeSeat and make another). Needs the client's `ow_a_` token.
    */
   async createSeat(worldId, opts) {
+    only("createSeat", opts, ["name", "role", "character"]);
     if (this.keyKind !== "account") {
       throw new TypeError("createSeat needs an account token (ow_a_): a seat is made by the person who answers for it");
     }

package/package.json

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