@farthershore/client 0.4.0 → 0.6.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
@@ -1,5 +1,23 @@
1
1
  # Changelog — @farthershore/client
2
2
 
3
+ ## [0.6.0] - 2026-11-18
4
+
5
+ - Use `/agent/v1/whoami` for credential validation; the retired `/management/whoami` endpoint is no longer supported.
6
+
7
+ ## [Unreleased]
8
+
9
+ - **Breaking:** Removed `businesses.rollback`; the retired publish workflow cannot produce a valid rollback target. Recover a Business contract through a reviewed repository fix and a new release.
10
+
11
+ - Stop frontend build waits on supersession and keep the awaited build identity fixed, including when it is missing from a status response.
12
+
13
+ ## [0.5.0] - 2026-11-09
14
+
15
+ - **Breaking:** `businesses.rollback` takes `publishId` and returns
16
+ `rollbackPublishId`; `businesses.publish` returns `publishId`. Requires the
17
+ matching platform release.
18
+
19
+ - **Breaking:** Removed business deletion, organization deletion, ownership transfer and Stripe disconnection methods. These actions require a person in the dashboard after fresh sign-in and typed-name confirmation. Owner-target membership changes are also dashboard-only; non-owner membership operations remain available.
20
+
3
21
  All notable changes to the API client are documented here. This package
4
22
  versions independently from the CLI and the other SDKs. Pre-1.0: minor versions
5
23
  may include breaking changes.
package/README.md CHANGED
@@ -5,8 +5,8 @@ namespaced, typed operation surface (`fs.runtimeTokens.revoke(…)`) over an
5
5
  authenticated `fetch` transport with exact retry and outcome semantics,
6
6
  pluggable credential sources, and typed errors.
7
7
 
8
- > **Status: `0.3.0`.** Pre-1.0: minor releases may include breaking changes.
9
- > Every response is typed. All but the publish-rollback receipt are generated
8
+ > **Status: `0.6.0`.** Pre-1.0: minor releases may include breaking changes.
9
+ > Every response is typed. Responses are generated
10
10
  > from the platform's zod schemas (through the API's OpenAPI components), so a
11
11
  > field exists in a type exactly when the server sends it.
12
12
 
@@ -66,7 +66,6 @@ The namespace path comes from the operation key (`runtime_token.revoke` →
66
66
  | Namespace | Covers |
67
67
  | -------------------- | --------------------------------------------------------------------------------------- |
68
68
  | `fs.agents` | Operating agents: list, status, runs, enable, disable |
69
- | `fs.agreements` | Economic agreements: read, preview, create, amend, subject pins |
70
69
  | `fs.analytics` | Event analytics: `timeseries`, `latency`, `top`, `log`, `query` |
71
70
  | `fs.auditLogs` | Organization and business audit logs, CSV export |
72
71
  | `fs.auth` | `context.read` (who am I), `context.issue`, `listOrganizations`, `selectedOrganization` |
@@ -74,7 +73,7 @@ The namespace path comes from the operation key (`runtime_token.revoke` →
74
73
  | `fs.backends` | Backends: read, create, bind, delete |
75
74
  | `fs.billing` | `stripe` (status, disconnect) and `taxSettings` |
76
75
  | `fs.bulletin` | Business bulletin: list, read, ack, resolve |
77
- | `fs.businesses` | Businesses, publish/rollback/status, `brand`, `docs`, `previewEnv`, `cors`, `rbac`, … |
76
+ | `fs.businesses` | Businesses, publish/status, `brand`, `docs`, `previewEnv`, `cors`, `rbac`, … |
78
77
  | `fs.changeSets` | Governed ChangeSet proposals and the apply `timeline` |
79
78
  | `fs.consumers` | Subscribers: read, block, remove, migrate, roles, RBAC, API keys |
80
79
  | `fs.environments` | Preview environments: read, create, delete |
@@ -82,7 +81,7 @@ The namespace path comes from the operation key (`runtime_token.revoke` →
82
81
  | `fs.knowledge` | Knowledge index (guide, business) |
83
82
  | `fs.makerTokens` | Organization maker tokens and their approvals |
84
83
  | `fs.notifications` | Notification preferences |
85
- | `fs.organizations` | Organizations, roles, members, invitations, ownership, overview |
84
+ | `fs.organizations` | Organizations, roles, non-owner members, invitations, overview |
86
85
  | `fs.personas` | Test personas and local-preview sign-in |
87
86
  | `fs.plans` | Compiled plans (read) |
88
87
  | `fs.platform` | Denial explanations, dependents, resource counts, workflow replay/rollback previews |
@@ -164,6 +163,11 @@ const build = await waitForFrontendBuild(fs, {
164
163
  });
165
164
  ```
166
165
 
166
+ The wait keeps the selected build's identity fixed. `FAILED`, `CANCELLED`, and
167
+ `SUPERSEDED` return immediately with `timedOut: false`; inspect `status` and
168
+ `error` before treating the result as success. A successful build is ready only
169
+ once that exact build is active.
170
+
167
171
  `paginate` fails with `PAGINATION_NOT_ADVANCING` rather than looping when a
168
172
  page does not advance. A starting `offset` or `limit` may be a number or a
169
173
  numeric string (`"50"`); anything else fails with `INVALID_PAGE_PARAMETER`
@@ -257,3 +261,5 @@ a successful read whose JSON body is malformed rejects with the parser's
257
261
  `SyntaxError` (it is not retried), and a request `body` that `JSON.stringify`
258
262
  cannot serialize (a `BigInt`, a cycle) throws its `TypeError` before anything
259
263
  is sent.
264
+
265
+ Human-only actions have no client methods: business or organization deletion, ownership transfer, and Stripe disconnection. The API also refuses delegated credentials for owner removal or demotion. Use the dashboard after fresh sign-in and typed-name confirmation.