@onlyworlds/sdk 4.124.2 → 4.125.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 +7 -0
- package/dist/index.d.ts +11 -4
- package/dist/index.js +6 -3
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,13 @@ earlier history lives in git log only.
|
|
|
5
5
|
|
|
6
6
|
## [Unreleased]
|
|
7
7
|
|
|
8
|
+
## [4.125.0] - 2026-11-01
|
|
9
|
+
|
|
10
|
+
### Added
|
|
11
|
+
|
|
12
|
+
- **`createWorldLink(worldId, { landsOn })` and `lands_on` on every link**: where a person link opens. `site` (the default) is onlyworlds.com's /join page; `dashboard` is the Dashboard's /join page, for someone invited to work in the Dashboard. Either page takes the same code; `dashboard` on an agent or player link is refused by the server. `OwWorldLink.lands_on` (and so `OwCreatedWorldLink`'s) is always present, `site` on an agent or player link.
|
|
13
|
+
- **`OwWorldLens.skipped`**: with `resolve` and `readAs`, a lens the reader read as cannot see (deleted or hidden from it) is not read: `skipped` is `not_found` and `reading` is null, so `reading` is now typed `OwWorldLensReading | null`.
|
|
14
|
+
|
|
8
15
|
## [4.124.2] - 2026-11-01
|
|
9
16
|
|
|
10
17
|
### Fixed
|
package/dist/index.d.ts
CHANGED
|
@@ -3183,6 +3183,8 @@ interface OwWorldLink {
|
|
|
3183
3183
|
name: string | null;
|
|
3184
3184
|
taken: boolean;
|
|
3185
3185
|
}>;
|
|
3186
|
+
/** Where the link opens: `site`, onlyworlds.com's /join page; `dashboard`, the Dashboard's /join page (a person link only). Either page takes the same code. Always `site` on an agent or player link. */
|
|
3187
|
+
lands_on: 'site' | 'dashboard';
|
|
3186
3188
|
[k: string]: unknown;
|
|
3187
3189
|
}
|
|
3188
3190
|
/** POST /account/worlds/{id}/links: the new link, with its code. The code is in this answer only: keel keeps a hash. */
|
|
@@ -3473,8 +3475,10 @@ interface OwWorldLens {
|
|
|
3473
3475
|
over_budget: boolean;
|
|
3474
3476
|
retired_assigned: boolean;
|
|
3475
3477
|
};
|
|
3476
|
-
/** With `resolve`: the reading of the lens for this caller (or the reader `readAs` names)
|
|
3477
|
-
reading?: OwWorldLensReading;
|
|
3478
|
+
/** With `resolve`: the reading of the lens for this caller (or the reader `readAs` names); null when it is `skipped`. */
|
|
3479
|
+
reading?: OwWorldLensReading | null;
|
|
3480
|
+
/** With `resolve` and `readAs`: `not_found` when the reader read as cannot see this lens (deleted or hidden from it), so it is not read and `reading` is null; the draught's word for a chosen lens it skips. */
|
|
3481
|
+
skipped?: 'not_found';
|
|
3478
3482
|
}
|
|
3479
3483
|
/** A lens's reading on worldLenses with `resolve`: what it keeps and what it cut, with why. */
|
|
3480
3484
|
interface OwWorldLensReading {
|
|
@@ -4889,8 +4893,10 @@ declare class OwV2Client {
|
|
|
4889
4893
|
* Character after themselves. A table takes no `character`, not even `new` (422, param
|
|
4890
4894
|
* `character`), and `characters` on a link for one is 422, even empty. A table counts once
|
|
4891
4895
|
* against the 50 pending invites; its seats count against the world's 50 players as each is
|
|
4892
|
-
* made, so a full world refuses the pick, never the link.
|
|
4893
|
-
*
|
|
4896
|
+
* made, so a full world refuses the pick, never the link. `landsOn` (a person link only):
|
|
4897
|
+
* `site`, the default, opens onlyworlds.com's /join page; `dashboard` opens the Dashboard's,
|
|
4898
|
+
* for someone invited to work there; either page takes the same code, and `dashboard` on an
|
|
4899
|
+
* agent or player link is refused. 201 with the code, shown in this answer only. Owner only: anyone else, and a world that doesn't exist, gets 404
|
|
4894
4900
|
* `not_found` (`err.isNotFound`). A world key is a TypeError before anything is sent.
|
|
4895
4901
|
*/
|
|
4896
4902
|
createWorldLink(worldId: string, opts: {
|
|
@@ -4903,6 +4909,7 @@ declare class OwV2Client {
|
|
|
4903
4909
|
preview?: boolean;
|
|
4904
4910
|
maxUses?: number;
|
|
4905
4911
|
characters?: string[];
|
|
4912
|
+
landsOn?: 'site' | 'dashboard';
|
|
4906
4913
|
}): Promise<OwCreatedWorldLink>;
|
|
4907
4914
|
/**
|
|
4908
4915
|
* GET /account/worlds/{worldId}/links -- the world's invite links, without their codes:
|
package/dist/index.js
CHANGED
|
@@ -1574,12 +1574,14 @@ var OwV2Client = class {
|
|
|
1574
1574
|
* Character after themselves. A table takes no `character`, not even `new` (422, param
|
|
1575
1575
|
* `character`), and `characters` on a link for one is 422, even empty. A table counts once
|
|
1576
1576
|
* against the 50 pending invites; its seats count against the world's 50 players as each is
|
|
1577
|
-
* made, so a full world refuses the pick, never the link.
|
|
1578
|
-
*
|
|
1577
|
+
* made, so a full world refuses the pick, never the link. `landsOn` (a person link only):
|
|
1578
|
+
* `site`, the default, opens onlyworlds.com's /join page; `dashboard` opens the Dashboard's,
|
|
1579
|
+
* for someone invited to work there; either page takes the same code, and `dashboard` on an
|
|
1580
|
+
* agent or player link is refused. 201 with the code, shown in this answer only. Owner only: anyone else, and a world that doesn't exist, gets 404
|
|
1579
1581
|
* `not_found` (`err.isNotFound`). A world key is a TypeError before anything is sent.
|
|
1580
1582
|
*/
|
|
1581
1583
|
async createWorldLink(worldId, opts) {
|
|
1582
|
-
only("createWorldLink", opts, ["reader", "role", "days", "inviterName", "withCharacter", "character", "preview", "maxUses", "characters"]);
|
|
1584
|
+
only("createWorldLink", opts, ["reader", "role", "days", "inviterName", "withCharacter", "character", "preview", "maxUses", "characters", "landsOn"]);
|
|
1583
1585
|
if (this.keyKind !== "account") {
|
|
1584
1586
|
throw new TypeError("createWorldLink needs an account token (ow_a_): only the world's owner makes links");
|
|
1585
1587
|
}
|
|
@@ -1592,6 +1594,7 @@ var OwV2Client = class {
|
|
|
1592
1594
|
if (opts.preview !== void 0) body.preview = opts.preview;
|
|
1593
1595
|
if (opts.maxUses !== void 0) body.max_uses = opts.maxUses;
|
|
1594
1596
|
if (opts.characters !== void 0) body.characters = opts.characters;
|
|
1597
|
+
if (opts.landsOn !== void 0) body.lands_on = opts.landsOn;
|
|
1595
1598
|
return this.request("POST", `/account/worlds/${seg("worldId", worldId)}/links`, { body });
|
|
1596
1599
|
}
|
|
1597
1600
|
/**
|