generated from coulomb/repo-seed
Bernd Worsch
3cac021213
Some checks failed
Test / test (push) Has been cancelled
Delivers the full Phase 9 external API layer: - Versioned REST API (/api/v2/) with OpenAPI 3.1 spec; enum arrays for widget_type, event_type, annotation category drawn live from registry tables - OAuth 2.0 client credentials flow (/api/v2/token); hub:*:write scopes gated on active HubCapabilityManifest FK - API key management: SHA256-hashed tokens, key_prefix for display, one-time reveal on creation, revocation support - TypeScript and Python consumer SDKs generated from registry tables (/api/v2/sdk/ihf-client.ts, /api/v2/sdk/ihf-client.py) - Webhook delivery: HMAC-SHA256 signing, append-only webhook_deliveries, fire-and-forget dispatch via forkIO, 3-retry logic - Admin API dashboard with 24h stats (request count, error rate, last seen) - Rate limiting (per-minute) and daily quota enforcement via api_request_log - Schema migration: api_consumers, api_keys, webhook_subscriptions (CHECK constraint on 6 framework lifecycle topics), webhook_deliveries (append-only trigger), api_request_log - ARCHITECTURE-LAYERS.md scorecard: 3.34 → 3.41 (approaching Strong) - contracts/functional/interaction-reporting-v1.md extended with Phase 9 endpoint catalogue and 422 validation error format GAAF: no bare TEXT discriminators; webhook event_type uses CHECK constraint over 6 allowed framework lifecycle topic strings (not widget event types). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
63 lines
1.8 KiB
Haskell
63 lines
1.8 KiB
Haskell
module Web.Controller.Api.V2.Registries where
|
|
|
|
-- Public (unauthenticated) endpoints that enumerate the registered vocabulary.
|
|
-- GET /api/v2/widget-types
|
|
-- GET /api/v2/event-types
|
|
-- GET /api/v2/annotation-categories
|
|
|
|
import Web.Types
|
|
import Generated.Types
|
|
import IHP.Prelude
|
|
import IHP.ControllerPrelude
|
|
import Data.Aeson (object, (.=))
|
|
|
|
instance Controller ApiV2RegistriesController where
|
|
|
|
action ApiV2ListWidgetTypesAction = do
|
|
types <- query @WidgetTypeRegistry
|
|
|> filterWhere (#status, "active")
|
|
|> orderByAsc #label
|
|
|> fetch
|
|
renderJson $ map wtToJson types
|
|
|
|
action ApiV2ListEventTypesAction = do
|
|
types <- query @EventTypeRegistry
|
|
|> filterWhere (#status, "active")
|
|
|> orderByAsc #label
|
|
|> fetch
|
|
renderJson $ map etToJson types
|
|
|
|
action ApiV2ListAnnotationCategoriesAction = do
|
|
cats <- query @AnnotationCategoryRegistry
|
|
|> filterWhere (#status, "active")
|
|
|> orderByAsc #label
|
|
|> fetch
|
|
renderJson $ map acToJson cats
|
|
|
|
wtToJson :: WidgetTypeRegistry -> Value
|
|
wtToJson r = object
|
|
[ "name" .= r.name
|
|
, "label" .= r.label
|
|
, "description" .= r.description
|
|
, "ownerHubId" .= r.ownerHubId
|
|
, "status" .= r.status
|
|
]
|
|
|
|
etToJson :: EventTypeRegistry -> Value
|
|
etToJson r = object
|
|
[ "name" .= r.name
|
|
, "label" .= r.label
|
|
, "description" .= r.description
|
|
, "ownerHubId" .= r.ownerHubId
|
|
, "status" .= r.status
|
|
]
|
|
|
|
acToJson :: AnnotationCategoryRegistry -> Value
|
|
acToJson r = object
|
|
[ "name" .= r.name
|
|
, "label" .= r.label
|
|
, "description" .= r.description
|
|
, "ownerHubId" .= r.ownerHubId
|
|
, "status" .= r.status
|
|
]
|