@onlyworlds/sdk 4.42.4 → 4.44.0

package/CHANGELOG.md

@@ -5,6 +5,17 @@ earlier history lives in git log only.
 
 ## [Unreleased]
 
+## [4.44.0] - 2026-10-22
+
+### Added
+- `changes({ after })` and `changesAll(since, { after })`: keel #514 (PR 152, D142, live 2026-10-22 00:55), `GET /changes?after=<ISO time>` returns only the changes made at or after that time, a filter and not a position: order, `cursor`, `has_more` and `head` are unchanged, and the window is read by passing the cursor back as `since` with the same `after`. A bad value is a 422 naming `after`.
+
+## [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);
@@ -3062,10 +3075,17 @@ declare class OwV2Client {
      * 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 a key
      * whose cursor carries no epoch); it is handed back as a string, like every cursor here.
+     * `after` (keel #514, D142): only the changes made at or after an ISO 8601 time (`updated_at` of an
+     * upsert, `deleted_at` of a delete; no offset means UTC). A filter, not a position: the order,
+     * `cursor`, `has_more` and `head` are as without it, so to read the whole window pass the cursor
+     * back as `since` with the same `after` until `has_more` is false (`changesAll` does). "Since
+     * yesterday" by the clock; a kept cursor is still the exact "since my last visit". Anything
+     * that is not a date and time is a 422 naming `after`.
      */
     changes(opts?: {
         since?: string;
         limit?: number;
+        after?: string;
     }): Promise<OwChangesPage>;
     /**
      * GET /changes?head=true -- where the feed is now, without a page: no element is read.
@@ -3092,7 +3112,9 @@ declare class OwV2Client {
      * return value; persist it for the next incremental pull (with the last page's
      * `head` and `epoch`: the view epoch the walk ran under, for a guest or a contributor).
      */
-    changesAll(since?: string): AsyncGenerator<OwChange, {
+    changesAll(since?: string, opts?: {
+        after?: string;
+    }): AsyncGenerator<OwChange, {
         cursor: string;
         head: number;
         epoch: number | null;
@@ -3332,8 +3354,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
@@ -542,9 +558,15 @@ var OwV2Client = class {
    * 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 a key
    * whose cursor carries no epoch); it is handed back as a string, like every cursor here.
+   * `after` (keel #514, D142): only the changes made at or after an ISO 8601 time (`updated_at` of an
+   * upsert, `deleted_at` of a delete; no offset means UTC). A filter, not a position: the order,
+   * `cursor`, `has_more` and `head` are as without it, so to read the whole window pass the cursor
+   * back as `since` with the same `after` until `has_more` is false (`changesAll` does). "Since
+   * yesterday" by the clock; a kept cursor is still the exact "since my last visit". Anything
+   * that is not a date and time is a 422 naming `after`.
    */
   async changes(opts = {}) {
-    const query = buildQuery({ since: opts.since, limit: opts.limit ?? this.changesPageSize });
+    const query = buildQuery({ since: opts.since, limit: opts.limit ?? this.changesPageSize, after: opts.after });
     const page = await this.request("GET", "/changes/", { query });
     return { ...page, cursor: String(page.cursor) };
   }
@@ -573,11 +595,11 @@ var OwV2Client = class {
    * return value; persist it for the next incremental pull (with the last page's
    * `head` and `epoch`: the view epoch the walk ran under, for a guest or a contributor).
    */
-  async *changesAll(since) {
+  async *changesAll(since, opts = {}) {
     let cursor = since;
     let page;
     do {
-      page = await this.changes({ since: cursor });
+      page = await this.changes({ since: cursor, after: opts.after });
       for (const op of page.changes) yield op;
       cursor = page.cursor;
     } while (page.has_more);
@@ -1003,8 +1025,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.44.0",
   "description": "TypeScript SDK for the OnlyWorlds API - build world-building applications with type safety",
   "type": "module",
   "exports": {