Repository navigation
v0.0.92
An owner can now install plugins, each app's own app.<vendor> data is kept to that app, and app.* items are hidden from lists and search as system.* items are. This release also carries everything planned for 0.0.91, which was never published.
Breaking: The marfa command line and the Rust core (the Swift package's working copy) refuse a server older than 0.0.91, so upgrade your server to 0.0.92 with or before them. The listing and search token include=system is now include=hidden, with no alias. An app's content or * scope no longer reaches app.* data: an app reaches its own vendor without naming it, and another app's only through a grant that names app.<vendor>.* or app.*. A device now declares only app.* types. Type provenance reads registered where it read user. POST /types refuses a new common.* type, which arrives only by installing a plugin. Exports are now archive version 2, which earlier releases cannot restore. The upgrade changes how the database is laid out, so it keeps a copy first.
Server
- Added: An owner can install a plugin, a bundle of types, the edge types they use and an optional connector, in one write with
POST /plugins, and list, read and remove plugins withGET /plugins,GET /plugins/{name}andDELETE /plugins/{name}. A newer version of a plugin may only add to what the installed version published, and removing a plugin keeps its types and items. Each install keeps the SHA-256 of the bundle it received. Docs - Added: A type's provenance names the plugin and version that installed it, and
commonis reserved for the shared type families that plugins bring.user.*holds the owner's own types. Docs - Added: An
app.<vendor>namespace belongs to the app that registered the first type under it. Only the owner moves a vendor to another app, withPUT /app-vendors/{vendor}, andGET /app-vendorslists who holds each one. On upgrade, a vendor that one app's types alone fill goes to that app, and any other vendor is held for the owner to give. Docs - Changed:
app.*items are left out of every list, search, count, view and the overview unless a request asks forinclude=hiddenor names the type exactly. A wildcard such asapp.acme.*opens no hidden type. The bin, exports and backups still carry them. Docs - Changed: Only installing a plugin or the owner's own credentials write a type's guidance. An app, or a key an app made, is refused guidance even with
schema.write. - Changed: Each release archive also carries Cloudflare's tunnel connector,
cloudflared, pinned and checked by its SHA-256. Nothing runs it in this release. - Fixed: A claim reads an
emailofnullas no email, and refuses an empty one naming the field, asPATCH /profiledoes. - Fixed: A server whose
MARFA_DATABASE_PATHis afile:URI withmode=rwcnow starts.
CLI
- Added:
marfa plugins installinstalls a plugin by name from the newest withmarfa/plugins release, or from a bundle file or source folder, and checks the bundle's SHA-256.list,getandremovemanage installed plugins, andcheck,bundleandindexwork offline. Docs - Added:
marfa apps vendors listshows which app holds eachapp.<vendor>namespace, andmarfa apps vendors movegives one to another app. Docs - Fixed: A Docker install made under a umask such as
002keeps its install folder private, so the next install into that folder is admitted.
Core
- Changed: A working copy keeps the
app.*items it holds, and leaves them out of local lists and search unless the request names their type exactly. Its bin shows them as the server's bin does. - Fixed: A queued write no longer goes out while restored rows are held, or ahead of a kept write.
TypeScript SDK
- Added:
@withmarfa/clienttypes the plugin and app vendor operations, and its listing options takeinclude=hiddenin place ofinclude=system.
Full changelog: v0.0.90...v0.0.92