Skip to content

pattern-storage

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

Tenant-scoped event-sourced store for feature source files (pattern-files). Registers a pattern-file entity with full CRUD handlers (pattern-file:create/update/delete/restore/list/detail) — the create handler derives a deterministic aggregate-id from (tenantId, path) via UUIDv5, so a duplicate-path attempt surfaces as a version_conflict 409 rather than a DB unique-violation. Soft-deletes are enabled (deletedAt) to allow future rollback via restore. All handlers are admin-only (TenantAdmin, SystemAdmin). Required by designer and publish; add it first in your feature list.

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_pattern_storage["pattern-storage"]
  subgraph how_reqs["Requires"]
    n_config["config"]
    n_tenant["tenant"]
  end
  subgraph how_provides["Provides"]
    n_cmd_pattern_storage_write_pattern_file_create(["create"])
    n_cmd_pattern_storage_write_pattern_file_delete(["delete"])
    n_cmd_pattern_storage_write_pattern_file_restore(["restore"])
    n_cmd_pattern_storage_write_pattern_file_update(["update"])
  end
  n_config --> n_pattern_storage
  n_tenant --> n_pattern_storage
  n_pattern_storage --> n_cmd_pattern_storage_write_pattern_file_create
  n_pattern_storage --> n_cmd_pattern_storage_write_pattern_file_delete
  n_pattern_storage --> n_cmd_pattern_storage_write_pattern_file_restore
  n_pattern_storage --> n_cmd_pattern_storage_write_pattern_file_update

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

  • pattern-storage:write:pattern-file:create
  • pattern-storage:write:pattern-file:delete
  • pattern-storage:write:pattern-file:restore
  • pattern-storage:write:pattern-file:update
  • Requires: config, tenant
  • Activation: always on (not toggleable)