message_react_add

message_react_add is implemented by handleMessageReactAdd in src/api/handlers/reaction/message_react_add.osl.

Legacy alias for reaction_add.

Access

Gate	Requirement
Authentication	Required by the central API gate.
Central permission	None. Resource, channel, ownership, or hierarchy checks may still apply in the handler/helpers.
Broadcast	Yes. The transport removes the internal marker and filters recipients by channel visibility.

Request

Every request includes cmd: "message_react_add" and may include an opaque listener correlation value.

Field	Validation / meaning
`channel`	`schema.string().defaultValue("")`
`thread_id`	`schema.string().defaultValue("")`
`id`	`schema.string().minLen(1)`
`emoji`	`schema.string().minLen(1).maxLen(200)`
`cmd`	`Read separately by the handler or a shared domain helper`

Validator source

The handler and shared validation path use these OSL schema definitions before normalization:

*schema.Schema schemaReactionChange = schema.object({
  channel: schema.string().defaultValue(""),
  thread_id: schema.string().defaultValue(""),
  id: schema.string().minLen(1),
  emoji: schema.string().minLen(1).maxLen(200)
})

Shared validation and domain flow: src/api/helpers/reactions.osl.

Processing path

handleCmd enforces authentication.
dispatchCmd routes message_react_add to handleMessageReactAdd.
The adapter validates and normalizes input, then calls its domain collaborators.
Durable mutations complete before the response or event is returned.
onMessage adds the request listener to direct responses and performs any marked broadcast.

Direct collaborators visible in the handler: reactionChange, messageContext, messageTimeoutLimit, canUserReactInChannel, storedMessageById, else, configGetString, storedMessageRewrite

Responses and events

Response/event command names visible in this adapter: message_react_add.

Validation and domain failures use:

{
  "cmd": "error",
  "val": "<message>",
  "src": "message_react_add",
  "listener": "<copied from request>"
}