@onlyworlds/sdk 4.42.4 → 4.43.0

package/CHANGELOG.md

@@ -5,6 +5,12 @@ earlier history lives in git log only.
 
 ## [Unreleased]
 
+## [4.43.0] - 2026-10-22
+
+### Added
+- `adopt(type, id, member)`: change who made an element, `POST /{type}/{id}/adopt` with `{member}` (keel #427, D141, live 2026-10-22 00:43). `member` is a membership id of the world or `'owner'` (`created_by` null). The owner's key or a co-builder's with its PIN; a contributor's is 403 `not_author` (`isNotAuthor`). Returns the updated element; the write takes a new `change_seq` and the feed carries the element with its new `created_by`.
+- `createWorldLink`'s `maxUses` is documented for person links too (keel #390, D140, live the same hour): 2 to 50 lets in that many accounts, each joining once with the link's role. The client sent it already; the comment said player links only.
+
 ## [4.42.4] - 2026-10-21
 
 ### Fixed

package/dist/index.d.ts

@@ -3028,6 +3028,19 @@ declare class OwV2Client {
     editLinks(type: ElementType | string, id: string, field: string, edit: OwLinkEdit, opts?: {
         ifMatch?: number;
     }): Promise<OwElement>;
+    /**
+     * POST /{type}/{id}/adopt with {member} -- change who made an element (keel #427, D141).
+     * `member` is a membership id of this world (a person or an AI seat, as `members()` lists
+     * them) or `'owner'`, which sets `created_by` to null. The world's owner key or a
+     * co-builder's (a person's or a seat's) with its PIN; a contributor's is 403 `not_author`
+     * (`err.isNotAuthor`), a member id the world lacks 404. Nothing else in the element changes,
+     * but the write stamps `changed_by` and `changed_via` and takes a new `change_seq`, so the
+     * feed carries the element with its new `created_by`. Returns the updated element. A
+     * contributor only changes what it created, so this hands it an element someone else made,
+     * or takes one back; when the element is hidden, or the member is a guest, the old and the
+     * new maker may each get a `view` reset on the feed.
+     */
+    adopt(type: ElementType | string, id: string, member: string | 'owner'): Promise<OwElement>;
     /**
      * POST /bulk -- up to ~1000 items. Partial success by default (HTTP 200
      * always; inspect per-slot numeric `status` + top-level `errors` flag);
@@ -3332,8 +3345,11 @@ declare class OwV2Client {
      * whoever opens the link first reads as it, until removed. `preview` (person and player links,
      * keel #422) to false: true puts the world's id in the link's path, so a chat that unfurls it
      * shows the world's name and picture (the code stays after `#`); true on an agent link is
-     * 422, param `preview`. `maxUses` (player links only, keel #422 PR 2) to 1, a link for one:
-     * 2 to 50 makes a table, one link that seats that many players, each picking one of
+     * 422, param `preview`. `maxUses` (person and player links; an agent link takes none) to 1, a
+     * link for one. On a person link (keel #390, D140) 2 to 50 lets in that many accounts, each
+     * joining once with the link's role, until every use is taken, it expires or it is revoked;
+     * who already joined stays. On a player link (keel #422 PR 2) 2 to 50 makes a table, one
+     * link that seats that many players, each picking one of
      * `characters` (Character ids of the world, in the order a pick screen shows them; a hidden
      * one is 422, param `characters`). `characters` empty or left out: each player names a fresh
      * Character after themselves. A table takes no `character`, not even `new` (422, param

package/dist/index.js

@@ -491,6 +491,22 @@ var OwV2Client = class {
   async editLinks(type, id, field, edit, opts = {}) {
     return this.request("POST", `/${type}/${id}/links/${field}`, { write: true, body: edit, ifMatch: opts.ifMatch });
   }
+  /**
+   * POST /{type}/{id}/adopt with {member} -- change who made an element (keel #427, D141).
+   * `member` is a membership id of this world (a person or an AI seat, as `members()` lists
+   * them) or `'owner'`, which sets `created_by` to null. The world's owner key or a
+   * co-builder's (a person's or a seat's) with its PIN; a contributor's is 403 `not_author`
+   * (`err.isNotAuthor`), a member id the world lacks 404. Nothing else in the element changes,
+   * but the write stamps `changed_by` and `changed_via` and takes a new `change_seq`, so the
+   * feed carries the element with its new `created_by`. Returns the updated element. A
+   * contributor only changes what it created, so this hands it an element someone else made,
+   * or takes one back; when the element is hidden, or the member is a guest, the old and the
+   * new maker may each get a `view` reset on the feed.
+   */
+  async adopt(type, id, member) {
+    if (typeof member !== "string" || member === "") throw new TypeError('adopt: member must be a membership id or "owner"');
+    return this.request("POST", `/${type}/${id}/adopt`, { write: true, body: { member } });
+  }
   // -- Bulk ----------------------------------------------------------------
   /**
    * POST /bulk -- up to ~1000 items. Partial success by default (HTTP 200
@@ -1003,8 +1019,11 @@ var OwV2Client = class {
    * whoever opens the link first reads as it, until removed. `preview` (person and player links,
    * keel #422) to false: true puts the world's id in the link's path, so a chat that unfurls it
    * shows the world's name and picture (the code stays after `#`); true on an agent link is
-   * 422, param `preview`. `maxUses` (player links only, keel #422 PR 2) to 1, a link for one:
-   * 2 to 50 makes a table, one link that seats that many players, each picking one of
+   * 422, param `preview`. `maxUses` (person and player links; an agent link takes none) to 1, a
+   * link for one. On a person link (keel #390, D140) 2 to 50 lets in that many accounts, each
+   * joining once with the link's role, until every use is taken, it expires or it is revoked;
+   * who already joined stays. On a player link (keel #422 PR 2) 2 to 50 makes a table, one
+   * link that seats that many players, each picking one of
    * `characters` (Character ids of the world, in the order a pick screen shows them; a hidden
    * one is 422, param `characters`). `characters` empty or left out: each player names a fresh
    * Character after themselves. A table takes no `character`, not even `new` (422, param

package/package.json

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