#13: the six inbox and record-panel routes move from the raw AlertsRouteProvider onto a MiddlewareSpecExtension "alerts" (prefix /alerts). Paths are unchanged. The committed fragment openapi/qqq-v1/alerts.yaml is checked by a contract test, and the server tests run in strict mode. Additive fields let Next stop hard-coding alerts names: the summary has inboxHref, and inbox items and panel alerts have actions with process names and hrefs. #14: the Alertmanager webhook moves to POST /qqq/hooks/alerts/alertmanager. The old /qqq/v1 path is an opt-in deprecated alias (legacyAlertmanagerPath, default off; it needs non-strict mode). The alias sends Deprecation and Sunset headers and logs a warning per call. #16: POST /alerts/record-panel/watch is removed; collaboration owns following a record. The record panel reports follow.available when the collaboration extension is registered. Existing record-scoped watch subscriptions stay readable and are deprecated. Follower fan-out waits for core RecordFollowersProviderInterface (STAND-IN(core=QRun-IO/qqq#1164, removeBy=4.1.0-RC.7)). The checkstyle header template now matches the short Apache header that the sources already use. The core baseline becomes 4.1.0-RC.6. Closes #13, closes #14, closes #16 (architecture review QRun-IO/qqq#1150, F2, F7, F12, F20). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
88 lines
2.9 KiB
Java
88 lines
2.9 KiB
Java
/*
|
|
* Copyright 2026 Kingsrook, LLC
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
package com.kingsrook.qbits.alerts.api;
|
|
|
|
|
|
import com.kingsrook.qqq.middleware.javalin.specs.BasicOperation;
|
|
import com.kingsrook.qqq.openapi.model.HttpMethod;
|
|
import com.kingsrook.qqq.openapi.model.Schema;
|
|
|
|
|
|
/*******************************************************************************
|
|
** Mark own notifications read.
|
|
*******************************************************************************/
|
|
public class InboxReadSpec extends AlertsJsonSpec
|
|
{
|
|
public static final String OPERATION_ID = "alertsInboxRead";
|
|
|
|
|
|
|
|
/*******************************************************************************
|
|
** Describe the established method and path.
|
|
*******************************************************************************/
|
|
@Override
|
|
public BasicOperation defineBasicOperation()
|
|
{
|
|
return (new BasicOperation().withHttpMethod(HttpMethod.POST).withPath("/alerts/inbox/read")
|
|
.withShortSummary("Mark own notifications read").withLongDescription("Uses the signed-in caller's permissions and record visibility."));
|
|
}
|
|
|
|
|
|
|
|
/*******************************************************************************
|
|
** Stable identifier for generated clients.
|
|
*******************************************************************************/
|
|
@Override
|
|
protected String operationId()
|
|
{
|
|
return (OPERATION_ID);
|
|
}
|
|
|
|
|
|
|
|
/*******************************************************************************
|
|
** Versioned response schema.
|
|
*******************************************************************************/
|
|
@Override
|
|
protected String getResponseSchemaName()
|
|
{
|
|
return ("AlertsMutationResultV1");
|
|
}
|
|
|
|
|
|
|
|
/*******************************************************************************
|
|
** Recipient selectors; precedence is id, ids, alertId, then all.
|
|
*******************************************************************************/
|
|
@Override
|
|
protected Schema defineRequestBodySchema()
|
|
{
|
|
return (new Schema().withRefToSchema("AlertsInboxTargetV1"));
|
|
}
|
|
|
|
|
|
|
|
/*******************************************************************************
|
|
** Invoke the existing service with the caller session.
|
|
*******************************************************************************/
|
|
@Override
|
|
protected Object handle(JsonInput input) throws Exception
|
|
{
|
|
return (api().markRead(input.getBody()));
|
|
}
|
|
}
|