Skip to content

publish

Enterprise Part of the commercial Kumiko Enterprise offering — not in the open framework.

Turns tenant pattern-files into a runnable app bundle and provides read-side time-travel over the edit history. Key handlers: preview:get materialises the current (or historical asOf) file tree as JSON; build:trigger materialises and passes the tree to a Bun subprocess build, returning bundle size; history:get lists distinct event timestamps as rollback candidates; validation:check runs in-memory parseSourceFile per file (and optionally tsc + Biome via subprocess in mode="full"); rollback:apply computes a diff between an asOf snapshot and the live state, then issues compensating create/update/delete writes through pattern-storage so rollbacks are new events, not history mutation. Requires pattern-storage.

This Enterprise implementation is optional. If you need a narrower or domain-specific version, you can build an app-owned feature, handler, or job with Kumiko’s public extension points.

Use this package when you want the maintained implementation, its existing contracts, and the surrounding operational behavior. A custom implementation is not drop-in compatible automatically: your app owns its authorization, validation, integrations, tests, security review, and production operations.

Start with Features and composition and Custom write handlers.

What this feature needs to run (Requires, top) and the write commands this feature provides (Provides, bottom).

flowchart TB
  n_publish["publish"]
  subgraph how_reqs["Requires"]
    n_pattern_storage["pattern-storage"]
  end
  subgraph how_provides["Provides"]
    n_cmd_publish_write_build_trigger(["trigger"])
    n_cmd_publish_write_rollback_apply(["apply"])
  end
  n_pattern_storage --> n_publish
  n_publish --> n_cmd_publish_write_build_trigger
  n_publish --> n_cmd_publish_write_rollback_apply

Provides — write commands this feature registers (dispatch them through the command bus):

  • publish:write:build:trigger
  • publish:write:rollback:apply