coulomb/inter-hub
2
0
Fork 0
generated from coulomb/repo-seed
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

feat(P6/T02-T03): EnvelopeEmissionContract and InteractionReportingContract

Browse Source 
T02: EnvelopeEmissionContractsController (index+show, read-only); widgetEnvelope
helper validates against contract v1.0 required attributes with inline warning
on missing view-context; adapterStatusBadge helper added to Application.Helper.View.

T03: InteractionReportingContractsController (index+show, read-only); API endpoint
POST /api/v1/interaction-events with bearer token auth against hub.api_key,
contract v1.0 field validation, and 201/422/401 responses.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Bernd Worsch
2026-03-29 21:11:03 +00:00
parent 55af11342d
commit 14779f0768
13 changed files with 898 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

69
Web/View/InteractionReportingContracts/Index.hs Normal file
View File

@@ -0,0 +1,69 @@
module Web.View.InteractionReportingContracts.Index where
import Web.Types
import Generated.Types
import IHP.Prelude
import IHP.ViewPrelude
import Application.Helper.View (adapterStatusBadge)
data IndexView = IndexView
{ contracts :: ![InteractionReportingContract]
}
instance View IndexView where
html IndexView { .. } = [hsx|
<div class="flex items-center justify-between mb-6">
<div>
<h1 class="text-2xl font-semibold">Interaction Reporting Contracts</h1>
<p class="text-sm text-gray-500 mt-1">
Defines the REST endpoint and payload schema for external adapter event submission.
</p>
</div>
<a href={EnvelopeEmissionContractsAction}
class="text-sm text-gray-500 hover:text-gray-800">
← Envelope Contracts
</a>
</div>
{if null contracts
then [hsx|<p class="text-sm text-gray-400">No contracts found.</p>|]
else renderTable contracts}
|]
renderTable :: [InteractionReportingContract] -> Html
renderTable contracts = [hsx|
<div class="bg-white rounded-lg border border-gray-200 overflow-hidden">
<table class="w-full text-sm">
<thead class="bg-gray-50 border-b border-gray-200">
<tr>
<th class="text-left px-4 py-3 font-medium text-gray-600">Version</th>
<th class="text-left px-4 py-3 font-medium text-gray-600">Endpoint</th>
<th class="text-left px-4 py-3 font-medium text-gray-600">Auth</th>
<th class="text-left px-4 py-3 font-medium text-gray-600">Status</th>
<th class="text-left px-4 py-3 font-medium text-gray-600">Created</th>
</tr>
</thead>
<tbody class="divide-y divide-gray-100">
{forEach contracts renderRow}
</tbody>
</table>
</div>
|]
renderRow :: InteractionReportingContract -> Html
renderRow c = [hsx|
<tr class="hover:bg-gray-50">
<td class="px-4 py-3">
<a href={ShowInteractionReportingContractAction { interactionReportingContractId = c.id }}
class="font-mono text-indigo-600 hover:underline">v{c.contractVersion}</a>
</td>
<td class="px-4 py-3 font-mono text-xs text-gray-700">{c.endpointPath}</td>
<td class="px-4 py-3 text-xs text-gray-500">{c.authScheme}</td>
<td class="px-4 py-3">
<span class={adapterStatusBadge c.status <> " text-xs px-2 py-0.5 rounded font-medium"}>
{c.status}
</span>
</td>
<td class="px-4 py-3 text-gray-400 text-xs">{show c.createdAt}</td>
</tr>
|]

76
Web/View/InteractionReportingContracts/Show.hs Normal file
View File

@@ -0,0 +1,76 @@
module Web.View.InteractionReportingContracts.Show where
import Web.Types
import Generated.Types
import IHP.Prelude
import IHP.ViewPrelude
import Application.Helper.View (adapterStatusBadge)
data ShowView = ShowView
{ contract :: !InteractionReportingContract
}
instance View ShowView where
html ShowView { .. } = [hsx|
<div class="mb-6">
<a href={InteractionReportingContractsAction} class="text-sm text-gray-500 hover:text-gray-800">
← Reporting Contracts
</a>
</div>
<div class="flex items-center gap-3 mb-6">
<h1 class="text-2xl font-semibold">
Reporting Contract <span class="font-mono">v{contract.contractVersion}</span>
</h1>
<span class={adapterStatusBadge contract.status <> " text-xs px-2 py-0.5 rounded font-medium"}>
{contract.status}
</span>
</div>
{forEach (contractDescription contract) (\d -> [hsx|
<p class="text-sm text-gray-600 mb-6">{d}</p>
|])}
<div class="grid grid-cols-1 gap-4">
<div class="bg-white rounded-lg border border-gray-200 p-5">
<h2 class="text-sm font-semibold text-gray-700 mb-3">Endpoint</h2>
<div class="flex items-center gap-2">
<span class="bg-green-100 text-green-800 text-xs font-bold px-2 py-0.5 rounded">POST</span>
<code class="text-sm text-gray-800">{contract.endpointPath}</code>
</div>
<div class="mt-2 text-xs text-gray-500">Auth: <code>{contract.authScheme}</code></div>
</div>
<div class="bg-white rounded-lg border border-gray-200 p-5">
<h2 class="text-sm font-semibold text-gray-700 mb-3">Required Fields</h2>
<pre class="text-xs bg-gray-50 rounded p-3 overflow-auto">{tshow contract.requiredFields}</pre>
</div>
<div class="bg-white rounded-lg border border-gray-200 p-5">
<h2 class="text-sm font-semibold text-gray-700 mb-3">Accepted Event Types</h2>
<pre class="text-xs bg-gray-50 rounded p-3 overflow-auto">{tshow contract.acceptedEventTypes}</pre>
</div>
</div>
<div class="mt-6 bg-blue-50 border border-blue-200 rounded p-4 text-sm">
<h3 class="font-semibold text-blue-800 mb-2">Example Request</h3>
<pre class="text-xs text-blue-900 overflow-auto">curl -X POST {contract.endpointPath} \
-H "Authorization: Bearer &lt;hub-api-key&gt;" \
-H "Content-Type: application/json" \
-d '{"{"}
"widget_id": "&lt;uuid&gt;",
"hub_id": "&lt;uuid&gt;",
"event_type": "clicked",
"occurred_at": "2026-03-29T12:00:00Z"
{"}"}'</pre>
</div>
<div class="mt-4 text-xs text-gray-400">
Created: {show contract.createdAt}
</div>
|]
contractDescription :: InteractionReportingContract -> [Text]
contractDescription c = case c.description of
Just d -> [d]
Nothing -> []