@onlyworlds/sdk 4.60.0 → 4.61.0

package/AGENTS.md

@@ -27,7 +27,7 @@ against live data). The v1 surface (`OnlyWorldsClient`, the `ElementType` enum)
 - Never send a `"world"` field in payloads — world identity comes from the API key (422 otherwise).
 - v2 link fields use ONE name both directions (no `_ids` suffix — that is v1 dialect only).
 - PATCH is destructive on sent fields; use `editLinks` (atomic add/remove) for relationships.
-- Offline or stale edits: pass `{ ifMatch: el.change_seq }` to `patch`/`editLinks` (since 4.9.0).
+- Offline or stale edits: pass `{ ifMatch: el.change_seq }` to `patch`/`editLinks` (since 4.9.0) and `delete` (since 4.61.0, keel #563).
   If the element moved, nothing is written and `OwPreconditionFailedError` (412) carries
   `current`; the server never merges, the client decides.
 - Polling: `changesHead()` (since 4.15.0) gives `{head, cursor, epoch, unchanged}` without a

package/CHANGELOG.md

@@ -5,6 +5,13 @@ earlier history lives in git log only.
 
 ## [Unreleased]
 
+## [4.61.0] - 2026-10-22
+
+### Added
+
+- **`delete(type, id, { ifMatch })`** (keel #563, PR 183, live 2026-10-22 21:3x): `DELETE` reads `If-Match` exactly as `PATCH` does. With the element's `change_seq` as you read it, a delete of an element someone changed since is refused, `OwPreconditionFailedError` (412) with `current`, nothing deleted; on an element already gone it is the idempotent 204. Under a world's proposals switch a delete is never a proposal. The options object refuses an unknown key like every other.
+- Tests: the header sent and left out, the unknown option, the 412; each watched failing with the header dropped. The wire gate now reads from keel's document which Character operations take `If-Match` (it held a hand list of two and missed this one) and fails on 4.60.0.
+
 ## [4.60.0] - 2026-10-22
 
 ### Added

package/README.md

@@ -186,7 +186,7 @@ Edits to the world itself (its name, calendar, `public_read`) don't appear in th
 
 ### Only if unchanged
 
-A client that edits offline, or from a copy it has held a while, can ask for an update to land only if nobody changed the element since it was read: pass the `change_seq` you read as `ifMatch`, on `patch` or `editLinks`.
+A client that edits offline, or from a copy it has held a while, can ask for an update to land only if nobody changed the element since it was read: pass the `change_seq` you read as `ifMatch`, on `patch`, `editLinks` or `delete` (since 4.61.0: a delete of an element someone changed since you read it is refused, nothing deleted).
 
 ```typescript
 try {

package/dist/index.d.ts

@@ -3510,8 +3510,15 @@ declare class OwV2Client {
      * DELETE /{type}/{id}/ -- idempotent (204 on absent). Server writes a
      * tombstone AND scrubs the id from every other element's links in the same
      * transaction -- no client-side unlink pass needed, ever.
+     *
+     * `ifMatch` (keel #563, as on patch()): the element's `change_seq` as you read it. The delete
+     * lands only if nothing changed since; otherwise an OwPreconditionFailedError (412) whose
+     * `current` is the element as it is now, and nothing is deleted. On an element already gone it
+     * is the idempotent 204. Under a world's proposals switch a delete is never a proposal.
      */
-    delete(type: ElementType | string, id: string): Promise<void>;
+    delete(type: ElementType | string, id: string, opts?: {
+        ifMatch?: number;
+    }): Promise<void>;
     /**
      * POST /{type}/{id}/links/{field} with {add, remove} -- atomic link merge.
      * Dedupes, tolerates already-present/already-absent ids. Returns the FULL

package/dist/index.js

@@ -766,9 +766,15 @@ var OwV2Client = class {
    * DELETE /{type}/{id}/ -- idempotent (204 on absent). Server writes a
    * tombstone AND scrubs the id from every other element's links in the same
    * transaction -- no client-side unlink pass needed, ever.
+   *
+   * `ifMatch` (keel #563, as on patch()): the element's `change_seq` as you read it. The delete
+   * lands only if nothing changed since; otherwise an OwPreconditionFailedError (412) whose
+   * `current` is the element as it is now, and nothing is deleted. On an element already gone it
+   * is the idempotent 204. Under a world's proposals switch a delete is never a proposal.
    */
-  async delete(type, id) {
-    await this.request("DELETE", `/${type}/${id}/`, { write: true, elementWrite: true, allowEmpty: true });
+  async delete(type, id, opts = {}) {
+    only("delete", opts, ["ifMatch"]);
+    await this.request("DELETE", `/${type}/${id}/`, { write: true, elementWrite: true, allowEmpty: true, ifMatch: opts.ifMatch });
   }
   /**
    * POST /{type}/{id}/links/{field} with {add, remove} -- atomic link merge.

package/package.json

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