@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.
Files changed (2) hide show
  1. package/README.md +17 -7
  2. 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; a plugin that still runs in the app's own page is not held
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, ported (Insights, Spending Trends, Upcoming, Forecast, Debt payoff) | A sandboxed frame | The sandbox and the host's broker (below) |
332
- | Bundled, not ported yet (Budgets, Import CSV) | **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 |
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. `isolated: true` can only
337
- move a plugin towards the frame. A manifest cannot ask for the page, and a
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.7.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.5"
59
+ "vitest": "^5.1.0"
60
60
  },
61
61
  "dependencies": {
62
62
  "zod": "^4.6.7"