@wickermoney/plugin-sdk 0.7.0 → 0.8.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/README.md +17 -7
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -209,8 +209,8 @@ granted exactly the tables its manifest lists. A query against any other table
|
|
|
209
209
|
is refused.
|
|
210
210
|
|
|
211
211
|
For your plugin's UI code, the broker and the server hold a plugin that runs in a
|
|
212
|
-
frame to these grants
|
|
213
|
-
to them. See [Trust model](#trust-model).
|
|
212
|
+
frame to these grants. A plugin that ran in the app's own page (none does today)
|
|
213
|
+
would not be held to them. See [Trust model](#trust-model).
|
|
214
214
|
|
|
215
215
|
### Widget
|
|
216
216
|
|
|
@@ -328,13 +328,15 @@ Where a plugin's UI runs decides what it can do.
|
|
|
328
328
|
|
|
329
329
|
| Plugin | UI runs in | What contains it |
|
|
330
330
|
| --- | --- | --- |
|
|
331
|
-
| Bundled
|
|
332
|
-
|
|
|
331
|
+
| Bundled (Insights, Spending Trends, Upcoming, Forecast, Debt payoff, Budgets, Import CSV: every one today) | A sandboxed frame | The sandbox and the host's broker (below) |
|
|
332
|
+
| A bundled plugin the host lists for the page (**none today**) | **The app's own page** | Nothing: fully trusted, in the host's origin, with the signed-in user's session. `requiredTables`, the `x-wickermoney-plugin` header and the checks in `ctx.api` are developer feedback there, not a boundary |
|
|
333
333
|
| Third-party (a manifest the operator added) | A sandboxed frame, **always** | The sandbox and the broker |
|
|
334
334
|
|
|
335
335
|
Which row a plugin is in is decided by the host, never by the manifest. In-page
|
|
336
|
-
mode is a host-internal list of bundled plugin ids
|
|
337
|
-
|
|
336
|
+
mode is a host-internal list of bundled plugin ids, and it is empty today: no
|
|
337
|
+
bundled plugin runs in the app's own page. The host still has the code to run a
|
|
338
|
+
listed plugin there, so the row is not gone, only unused. `isolated: true` can
|
|
339
|
+
only move a plugin towards the frame. A manifest cannot ask for the page, and a
|
|
338
340
|
plugin whose `remoteEntry` is not served by the host has no path into it.
|
|
339
341
|
|
|
340
342
|
### What the frame gives you, and what it takes away
|
|
@@ -415,7 +417,15 @@ $hex = (Get-FileHash -Algorithm SHA384 'assets\RunwayWidget-1a2b3c.js').Hash
|
|
|
415
417
|
[SECURITY.md](https://github.com/WickerMoney/wicker-money/blob/main/SECURITY.md)
|
|
416
418
|
for the full statement. Admission control (the operator choosing what to pin)
|
|
417
419
|
is the backstop, so only add a plugin you have read.
|
|
418
|
-
- The broker and token path have not had an independent security review
|
|
420
|
+
- The broker and token path have not had an independent security review, and
|
|
421
|
+
every bundled plugin's UI uses them too.
|
|
422
|
+
- The frame holds your plugin to its grants and its own routes, and nothing makes
|
|
423
|
+
that code harmless inside them. A bundled plugin's frame can call every route of
|
|
424
|
+
its own plugin, so it can change that plugin's data (Budgets its budgets, Import
|
|
425
|
+
CSV analyze, import and undo imports); a third-party plugin has no routes of its
|
|
426
|
+
own to call.
|
|
427
|
+
- The owner's consent step before a third-party plugin is switched on is in the
|
|
428
|
+
Settings page only; a request sent straight to the API does not ask.
|
|
419
429
|
- `requiredTables` is a **declaration** for your UI code, and what the grant
|
|
420
430
|
holds the broker and server to. Declare it honestly.
|
|
421
431
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@wickermoney/plugin-sdk",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.8.0",
|
|
4
4
|
"license": "Apache-2.0",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -56,7 +56,7 @@
|
|
|
56
56
|
"@types/react": "^19.3.0",
|
|
57
57
|
"react": "^19.3.1",
|
|
58
58
|
"typescript": "^6.0.3",
|
|
59
|
-
"vitest": "^5.0
|
|
59
|
+
"vitest": "^5.1.0"
|
|
60
60
|
},
|
|
61
61
|
"dependencies": {
|
|
62
62
|
"zod": "^4.6.7"
|