@onlyworlds/sdk 4.43.0 → 4.44.0

package/CHANGELOG.md

@@ -5,6 +5,11 @@ 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

package/dist/index.d.ts

@@ -3075,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.
@@ -3105,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;

package/dist/index.js

@@ -558,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) };
   }
@@ -589,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);

package/package.json

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