@onlyworlds/sdk 4.16.0 → 4.17.0

package/CHANGELOG.md

@@ -5,6 +5,15 @@ earlier history lives in git log only.
 
 ## [Unreleased]
 
+## [4.17.0] — 2026-10-12
+
+### Added
+- **`changesAll` returns `epoch`** beside `cursor` and `head`: the last page's, so a full walk
+  says which view epoch it ran under (a guest's integer; `null` for other keys or a keel
+  without the field) and the first poll after it needs no extra walk to learn it. Live on
+  Moppetopia: a full walk of 465 changes returns `{ cursor, head: 818, epoch: null }`. The first
+  tests of `changesAll`'s return value (Temper, h29 #3534).
+
 ## [4.16.0] — 2026-10-12
 
 ### Added
@@ -16,6 +25,8 @@ earlier history lives in git log only.
   page both carry `epoch: null`). The wire gate now holds `OwChangesPage` and `OwBulkResponse`
   to keel's `ChangesPage` and `BulkResult` (keel #108), and failed on 4.15.0 for the missing
   `epoch` before this release.
+  Published from tag `v4.16.0`; the workflow's read-back gave up before npm showed the
+  version, so the tarball (shasum `d08de22b`) was read back by hand against a build of the tag.
 
 ## [4.15.0] — 2026-10-12
 

package/dist/index.d.ts

@@ -2388,11 +2388,13 @@ declare class OwV2Client {
     /**
      * Walk the feed from `since` (or from zero = full export) to the current
      * tail, yielding ops in order. Returns the final cursor via the generator's
-     * return value; persist it for the next incremental pull.
+     * 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).
      */
     changesAll(since?: string): AsyncGenerator<OwChange, {
         cursor: string;
         head: number;
+        epoch: number | null;
     }>;
     /**
      * POST /media/ticket -- permission to upload ONE image into this world (a write

package/dist/index.js

@@ -347,7 +347,8 @@ var OwV2Client = class {
   /**
    * Walk the feed from `since` (or from zero = full export) to the current
    * tail, yielding ops in order. Returns the final cursor via the generator's
-   * return value; persist it for the next incremental pull.
+   * 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).
    */
   async *changesAll(since) {
     let cursor = since;
@@ -357,7 +358,7 @@ var OwV2Client = class {
       for (const op of page.changes) yield op;
       cursor = page.cursor;
     } while (page.has_more);
-    return { cursor: page.cursor, head: page.head };
+    return { cursor: page.cursor, head: page.head, epoch: page.epoch ?? null };
   }
   // -- Images ---------------------------------------------------------------
   /**

package/package.json

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