Repository navigation
v0.0.93
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 /connectorskeep 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,
feedunless you choose otherwise. - Added:
PUTandDELETE /items/{id}/extensions/{namespace}take an optionalread_revision, and every extension read returns the namespace'srevision. When someone else changed the namespace since you read it, the write is refused409 version_conflictwith 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.raisedhears about it. Docs
CLI
- Added:
marfa hosts add,list,get,linkandremovemanage connector hosts, andmarfa plugins assigngives a plugin's connector to a host. Docs - Added:
marfa plugins settingsshows and sets a plugin connector's settings,marfa plugins secretsets a secret from standard input or a prompt that does not echo, andmarfa plugins mapping show,setandrewritemanage its mapping. Docs - Fixed: After a restore into a new instance at the same address,
marfa folders removenow 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/clienttypes the connector host, plugin connector settings and mapping operations, and the extensionread_revisionparameter.
Full changelog: v0.0.92...v0.0.93