@onlyworlds/sdk 4.153.0 → 4.154.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -5,6 +5,12 @@ earlier history lives in git log only.
5
5
 
6
6
  ## [Unreleased]
7
7
 
8
+ ## [4.154.0] - 2026-11-11
9
+
10
+ ### Added
11
+
12
+ - **`OwFileAddedBy.owner`**: true when the world's current owner added the file, through any door (the site, the API, or an agent with the owner's own keys; a seat the owner sponsors is the seat's, false); false for everyone else, on every file of a world with no owner, and on a past owner's files once the world has another owner. onlyworlds.com serves it on every row of `listFiles` and `worldFiles`. `membership` is null both for the owner's files and for a file whose membership no longer exists, and `owner` tells the two apart: a null `membership` with `owner` false is a former member, and such a file's `name` is "a former member" (it was an empty string for a member whose account was deleted).
13
+
8
14
  ## [4.153.0] - 2026-11-11
9
15
 
10
16
  ### Changed
package/dist/index.d.ts CHANGED
@@ -3930,14 +3930,23 @@ interface OwUploadedImage {
3930
3930
  * picture (that is `image_url`).
3931
3931
  */
3932
3932
  type OwFileKind = 'pdf' | 'txt' | 'md' | 'json' | 'csv' | 'yaml' | 'toml' | 'zip' | 'png' | 'jpg' | 'webp' | 'avif';
3933
- /** Who added a file. */
3933
+ /**
3934
+ * Who added a file. A removed member's file keeps its membership id and name; a file whose member's account was
3935
+ * deleted keeps its membership id and is named "a former member".
3936
+ */
3934
3937
  interface OwFileAddedBy {
3935
- /** A member's or a seat's name; the owner's username for the owner's keys. */
3938
+ /** A member's or a seat's name; the owner's username for the owner's keys; "a former member" where no one is left to name. */
3936
3939
  name: string;
3937
- /** Their membership id; null for the owner's keys. */
3940
+ /** Their membership id; null for the owner's files and for a file whose membership no longer exists (`owner` tells the two apart). */
3938
3941
  membership: string | null;
3939
3942
  /** True when an agent added it: an agent seat, the MCP surface, or a key that declared an agent. */
3940
3943
  agent: boolean;
3944
+ /**
3945
+ * True when the world's current owner added the file, through any door (the site, the API, or an agent with the
3946
+ * owner's own keys; a seat the owner sponsors is the seat's, false). False for everyone else, on every file of a world
3947
+ * with no owner, and on a past owner's files once the world has another owner. Since 4.154.0.
3948
+ */
3949
+ owner: boolean;
3941
3950
  }
3942
3951
  /** One file on an element, as listFiles returns it. */
3943
3952
  interface OwFileRow {
@@ -5063,8 +5072,8 @@ declare class OwV2Client {
5063
5072
  }): Promise<OwRemovedImage>;
5064
5073
  /**
5065
5074
  * GET /{type}/{id}/files -- the element's files, newest first: each with its name, kind,
5066
- * size in bytes, label (or null), who added it (`added_by.agent` is true when an agent did)
5067
- * and when. Any key that may read the element; a file is seen by whoever may see its
5075
+ * size in bytes, label (or null), who added it (`added_by.agent` is true when an agent did,
5076
+ * `added_by.owner` when the world's current owner did) and when. Any key that may read the element; a file is seen by whoever may see its
5068
5077
  * element, and an element the key cannot see answers 404 `not_found`. Returns the rows
5069
5078
  * (keel sends them as `{ data }`, with no paging). Files never ride on the element: they
5070
5079
  * are not in its body, its `change_seq` or /changes.
package/dist/index.js CHANGED
@@ -1382,8 +1382,8 @@ var OwV2Client = class {
1382
1382
  // -- Files on elements ---------------------------------------------
1383
1383
  /**
1384
1384
  * GET /{type}/{id}/files -- the element's files, newest first: each with its name, kind,
1385
- * size in bytes, label (or null), who added it (`added_by.agent` is true when an agent did)
1386
- * and when. Any key that may read the element; a file is seen by whoever may see its
1385
+ * size in bytes, label (or null), who added it (`added_by.agent` is true when an agent did,
1386
+ * `added_by.owner` when the world's current owner did) and when. Any key that may read the element; a file is seen by whoever may see its
1387
1387
  * element, and an element the key cannot see answers 404 `not_found`. Returns the rows
1388
1388
  * (keel sends them as `{ data }`, with no paging). Files never ride on the element: they
1389
1389
  * are not in its body, its `change_seq` or /changes.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@onlyworlds/sdk",
3
- "version": "4.153.0",
3
+ "version": "4.154.0",
4
4
  "description": "TypeScript SDK for the OnlyWorlds API - build world-building applications with type safety",
5
5
  "type": "module",
6
6
  "exports": {