Skip to content

v0.0.93

Choose a tag to compare

@github-actions github-actions released this 22 Nov 06:21
6a65653

A plugin's connector can now run on a connector host the owner links once, with its settings, secrets and mapping kept in Marfa, and a synced folder stranded by a restore into a new instance can now be removed without losing track of its edits.

Server

  • Added: An owner can make a connector host, one machine that runs connectors, and link it once with a one-time link that expires after 15 minutes. Each plugin's connector is assigned to a host, which mints that connector's own key. Removing a plugin stops its connector and says what went and what stayed. Connectors that register themselves with POST /connectors keep working. Docs
  • Added: A plugin's connector can declare settings, and Marfa keeps their values. The owner reads and sets them with connectors.manage, and the connector reads them from its own registration. A secret is sealed on the server and is only ever given back to that connector's own key. An export names each secret without its value, so after a restore onto another machine you set it again.
  • Added: An owner can set a plugin connector's mapping: for each kind it brings, whether it comes in, the type and tier it lands as, its status words and where each field gets its value. On a type the connector does not own, its key writes and reads only the items under its own source, and its new items land at the mapping's tier, feed unless you choose otherwise.
  • Added: PUT and DELETE /items/{id}/extensions/{namespace} take an optional read_revision, and every extension read returns the namespace's revision. When someone else changed the namespace since you read it, the write is refused 409 version_conflict with the current value, and nothing changes.
  • Fixed: When every database write fails, such as on a full disk, the attention check still runs, so a webhook listening for attention.raised hears about it. Docs

CLI

  • Added: marfa hosts add, list, get, link and remove manage connector hosts, and marfa plugins assign gives a plugin's connector to a host. Docs
  • Added: marfa plugins settings shows and sets a plugin connector's settings, marfa plugins secret sets a secret from standard input or a prompt that does not echo, and marfa plugins mapping show, set and rewrite manage its mapping. Docs
  • Fixed: After a restore into a new instance at the same address, marfa folders remove now takes a folder with unsent edits off the list, keeps its files, and names every file holding a change it could not send, with numbered steps to send those changes to the new instance. Docs

Core

  • Fixed: An item recreated after the server was restored from an older backup keeps the source it was made under, instead of moving to the key's own source or being refused.
  • Fixed: A create resent under another key is read by its ID first, so a lost answer no longer lets the resend overwrite someone else's later edit.
  • Fixed: An extension write carries the revision you read, so a refused write is held as a conflict with your value kept, and a resend after a lost answer does not block itself.

TypeScript SDK

  • Added: @withmarfa/client types the connector host, plugin connector settings and mapping operations, and the extension read_revision parameter.

Full changelog: v0.0.92...v0.0.93