Skip to content

v0.0.92

Choose a tag to compare

@github-actions github-actions released this 22 Nov 00:40
62da8e1

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 with GET /plugins, GET /plugins/{name} and DELETE /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 common is 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, with PUT /app-vendors/{vendor}, and GET /app-vendors lists 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 for include=hidden or names the type exactly. A wildcard such as app.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 email of null as no email, and refuses an empty one naming the field, as PATCH /profile does.
  • Fixed: A server whose MARFA_DATABASE_PATH is a file: URI with mode=rwc now starts.

CLI

  • Added: marfa plugins install installs 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, get and remove manage installed plugins, and check, bundle and index work offline. Docs
  • Added: marfa apps vendors list shows which app holds each app.<vendor> namespace, and marfa apps vendors move gives one to another app. Docs
  • Fixed: A Docker install made under a umask such as 002 keeps 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/client types the plugin and app vendor operations, and its listing options take include=hidden in place of include=system.

Full changelog: v0.0.90...v0.0.92