Skip to content

Catalog and install review: gated plugins and public endpoints #1713

Open

Description

@michielbdejong

Repo: ontola/atomic-server. Base branch: feat/plugin-debug.
Design: docs/design/server-plugin-routes.md (atomic-plugins PR #108, for atomic-plugins#88), sections 0.5, 2.9, 2.10.
Depends on: #1711 (hostFeatures), #1712 (requires, refusal problem).

Browser (data-browser) only. The browser has no build gate; it follows
hostFeatures.

Scope

  • Catalog, from hostFeatures.pluginRoutes and each entry's requires:
    • not compiled: hide gated plugins; one line at the end of the list: "N
      plugins need server features this server doesn't have". A direct link
      shows the plugin page with the refusal text and no Install button.
    • compiled, level too low: show with a "Needs public endpoints" chip in
      the needs-attention status-pill style; Install disabled; text names
      the switch and the level needed.
    • gates open: normal.
  • Render the host-feature-unavailable problem wherever an install or
    upgrade can fail, with its surfaces list.
  • Install and upgrade review: a "Public endpoints" section listing each
    route (path, methods, principal, auth, what it exposes), well-known
    claims, write targets, keys and tokens, the public URL that becomes the
    identity, and "Anyone on the internet can call these endpoints; this
    plugin decides what they may see." The upgrade diff shows added, removed
    and widened surfaces.
  • Reuse the shared plugin UI language (--pl-* tokens, header row, status
    pill, inline error banner). No new components.

Acceptance

Component tests for the three catalog states and the review section, and
an e2e test against a default build showing a gated fixture plugin hidden
and its direct link refused.

From the design in ontola/atomic-plugins#108 (docs/design/server-plugin-routes.md, #88). Filed by the atomic-plugins oversight session.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions