@topolo/sdk 0.10.5 → 0.11.1
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/README.md +8 -28
- package/dist/index.cjs +32 -2241
- package/dist/index.d.cts +52 -1459
- package/dist/index.d.ts +52 -1459
- package/dist/index.js +32 -2231
- package/dist/node/credential-store.cjs +76 -46
- package/dist/node/credential-store.js +77 -47
- package/package.json +5 -2
package/README.md
CHANGED
|
@@ -111,13 +111,11 @@ credential-scoped registry is the source of truth:
|
|
|
111
111
|
id, slug, or name — including apps registered after this package was built.
|
|
112
112
|
- `friendlyAppId(entry)` derives the display id from a live catalog entry.
|
|
113
113
|
|
|
114
|
-
`DEFAULT_APP_URLS`
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
`listBundledServices()` reads that snapshot and is deprecated for anything
|
|
120
|
-
behavior-deciding.
|
|
114
|
+
`DEFAULT_APP_URLS` contains only the `auth` and `developers` bootstrap seeds —
|
|
115
|
+
the endpoints required before the registry can be consulted. If live discovery
|
|
116
|
+
is unavailable, directory APIs fail closed with
|
|
117
|
+
`application_catalog_unavailable`; the public SDK never substitutes compiled
|
|
118
|
+
first-party metadata.
|
|
121
119
|
|
|
122
120
|
## Action catalog
|
|
123
121
|
|
|
@@ -148,16 +146,6 @@ the same authorization and confirmation path as `callAction()`.
|
|
|
148
146
|
other transports that already hold canonical base64. `completionInput` supplies
|
|
149
147
|
any additional fields required by a declared URL-session completion action.
|
|
150
148
|
|
|
151
|
-
`APPLICATION_REQUIREMENTS` is the versioned app-build contract agents should
|
|
152
|
-
read before creating or expanding a Topolo app. `requirementsForApplication()`
|
|
153
|
-
filters the shared contract to the browser/API/tooling scopes implied by the app
|
|
154
|
-
catalog entry.
|
|
155
|
-
|
|
156
|
-
`auditApplicationRequirements()` and `auditAllApplicationRequirements()` turn
|
|
157
|
-
that contract into catalog-backed conformance reports and migration-queue items.
|
|
158
|
-
Catalog-visible evidence is marked directly; implementation details that require
|
|
159
|
-
code or docs inspection are deliberately marked `needs_review`.
|
|
160
|
-
|
|
161
149
|
## Native dashboard widgets
|
|
162
150
|
|
|
163
151
|
Launchable first-party applications populate the TopoloOne live workspace through
|
|
@@ -203,25 +191,17 @@ Still routes through auth + audit headers. Mutating methods still require
|
|
|
203
191
|
| `TopoloHttpError` | Other non-2xx responses |
|
|
204
192
|
| `TopoloSdkError` | Base class |
|
|
205
193
|
|
|
206
|
-
## Service URL
|
|
194
|
+
## Service URL overrides
|
|
207
195
|
|
|
208
|
-
Defaults target production.
|
|
196
|
+
Defaults target production. Self-hosted installations may override a service:
|
|
209
197
|
|
|
210
198
|
```ts
|
|
211
199
|
createTopolo({
|
|
212
200
|
/* ... */
|
|
213
201
|
serviceUrls: {
|
|
214
|
-
mail: 'https://mail.
|
|
202
|
+
mail: 'https://mail.example.com',
|
|
215
203
|
},
|
|
216
204
|
});
|
|
217
205
|
```
|
|
218
206
|
|
|
219
207
|
Or via env: `TOPOLO_SERVICE_URL_MAIL=...` (falls through `resolveServiceUrl`).
|
|
220
|
-
|
|
221
|
-
## Development
|
|
222
|
-
|
|
223
|
-
```bash
|
|
224
|
-
npm install
|
|
225
|
-
npm run build
|
|
226
|
-
npm run typecheck
|
|
227
|
-
```
|