@radzor/comment-system — LLM & AI Component | Radzor Registry

@radzor/comment-system

Threaded comment system with moderation, reactions, and pagination. Supports nested replies, content moderation actions, and reaction tracking with an in-memory store.

Chat & Messagingv0.1.0typescriptpythonServercommentsthreadsmoderationreactionsdiscussionsocialby Radzor

Install

View source on GitHub →

$npx radzor@latest add comment-system

⚠ Constraints: In-memory store; data is lost on restart. Soft-deletes preserve thread structure. Reaction toggling is idempotent. Thread IDs are opaque strings — use your resource identifier.

Inputs

Name	Type	Default	Description
maxDepth	number	5	Maximum nesting depth for threaded replies.
pageSize	number	20	Default number of comments per page.
allowedReactions	string[]	like,dislike,love,laugh,sad,angry	Allowed reaction types.

maxDepthnumber

Maximum nesting depth for threaded replies.

default: 5

pageSizenumber

Default number of comments per page.

default: 20

allowedReactionsstring[]

Outputs

Name	Type	Description
commentThread	CommentThread	Paginated list of comments with threading. .commentsComment[] .totalCountnumber .hasMoreboolean .pagenumber

commentThreadCommentThread

Paginated list of comments with threading.

.commentsComment[]

.totalCountnumber

.hasMoreboolean

.pagenumber

radzor.manifest.json

{
  "llm": {
    "constraints": "In-memory store; data is lost on restart. Soft-deletes preserve thread structure. Reaction toggling is idempotent. Thread IDs are opaque strings — use your resource identifier.",
    "usageExamples": "llm/examples.md",
    "integrationPrompt": "llm/integration.md"
  },
  "name": "@radzor/comment-system",
  "tags": [
    "comments",
    "threads",
    "moderation",
    "reactions",
    "discussion",
    "social"
  ],
  "events": [
    {
      "name": "onCommentAdded",
      "payload": {
        "authorId": "string",
        "parentId": "string",
        "threadId": "string",
        "commentId": "string"
      },
      "description": "Fired when a new comment is added."
    },
    {
      "name": "onCommentModerated",
      "payload": {
        "action": "string",
        "commentId": "string",
        "moderatorId": "string"
      },
      "description": "Fired when a comment is moderated (approved, rejected, flagged)."
    }
  ],
  "inputs": [
    {
      "name": "maxDepth",
      "type": "number",
      "default": 5,
      "required": false,
      "description": "Maximum nesting depth for threaded replies."
    },
    {
      "name": "pageSize",
      "type": "number",
      "default": 20,
      "required": false,
      "description": "Default number of comments per page."
    },
    {
      "name": "allowedReactions",
      "type": "string[]",
      "default": [
        "like",
        "dislike",
        "love",
        "laugh",
        "sad",
        "angry"
      ],
      "required": false,
      "description": "Allowed reaction types."
    }
  ],
  "radzor": "1.0.0",
  "actions": [
    {
      "name": "addComment",
      "params": [
        {
          "name": "threadId",
          "type": "string",
          "description": "Thread or resource identifier."
        },
        {
          "name": "authorId",
          "type": "string",
          "description": "Author's user identifier."
        },
        {
          "name": "content",
          "type": "string",
          "description": "Comment text content."
        },
        {
          "name": "parentId",
          "type": "string",
          "required": false,
          "description": "Parent comment ID for replies."
        }
      ],
      "returns": "Comment",
      "description": "Add a new comment or reply to a thread."
    },
    {
      "name": "deleteComment",
      "params": [
        {
          "name": "commentId",
          "type": "string",
          "description": "ID of the comment to delete."
        },
        {
          "name": "userId",
          "type": "string",
          "description": "ID of the user requesting deletion (must be author or moderator)."
        }
      ],
      "returns": "boolean",
      "description": "Soft-delete a comment (content replaced with '[deleted]')."
    },
    {
      "name": "editComment",
      "params": [
        {
          "name": "commentId",
          "type": "string",
          "description": "ID of the comment to edit."
        },
        {
          "name": "userId",
          "type": "string",
          "description": "ID of the user requesting the edit (must be author)."
        },
        {
          "name": "content",
          "type": "string",
          "description": "New comment content."
        }
      ],
      "returns": "Comment",
      "description": "Edit an existing comment."
    },
    {
      "name": "addReaction",
      "params": [
        {
          "name": "commentId",
          "type": "string",
          "description": "ID of the comment to react to."
        },
        {
          "name": "userId",
          "type": "string",
          "description": "User adding the reaction."
        },
        {
          "name": "reaction",
          "type": "string",
          "description": "Reaction type (must be in allowedReactions)."
        }
      ],
      "returns": "Comment",
      "description": "Toggle a reaction on a comment. Adding the same reaction again removes it."
    },
    {
      "name": "moderate",
      "params": [
        {
          "name": "commentId",
          "type": "string",
          "description": "ID of the comment to moderate."
        },
        {
          "name": "moderatorId",
          "type": "string",
          "description": "Moderator's user identifier."
        },
        {
          "name": "action",
          "type": "'approve' | 'reject' | 'flag'",
          "description": "Moderation action."
        }
      ],
      "returns": "Comment",
      "description": "Apply a moderation action to a comment."
    },
    {
      "name": "listComments",
      "params": [
        {
          "name": "threadId",
          "type": "string",
          "description": "Thread or resource identifier."
        },
        {
          "name": "page",
          "type": "number",
          "required": false,
          "description": "Page number (1-indexed)."
        },
        {
          "name": "sortBy",
          "type": "'newest' | 'oldest' | 'popular'",
          "required": false,
          "description": "Sort order for comments."
        }
      ],
      "returns": "CommentThread",
      "description": "List comments for a thread with pagination."
    }
  ],
  "outputs": [
    {
      "name": "commentThread",
      "type": "CommentThread",
      "fields": [
        {
          "name": "comments",
          "type": "Comment[]",
          "description": "Array of top-level comments with nested replies."
        },
        {
          "name": "totalCount",
          "type": "number",
          "description": "Total number of comments in the thread."
        },
        {
          "name": "hasMore",
          "type": "boolean",
          "description": "Whether more comments are available."
        },
        {
          "name": "page",
          "type": "number",
          "description": "Current page number."
        }
      ],
      "description": "Paginated list of comments with threading."
    }
  ],
  "runtime": "server",
  "version": "0.1.0",
  "category": "chat",
  "languages": [
    "typescript",
    "python"
  ],
  "description": "Threaded comment system with moderation, reactions, and pagination. Supports nested replies, content moderation actions, and reaction tracking with an in-memory store.",
  "dependencies": {
    "radzor": [],
    "packages": {}
  },
  "composability": {
    "connectsTo": [
      {
        "event": "onCommentAdded",
        "description": "Notify content owner of new comments",
        "compatibleWith": [
          "@radzor/notification-hub.action.send.body",
          "@radzor/email-send.action.send.message",
          "@radzor/push-notification.action.sendToDevice.token"
        ]
      },
      {
        "event": "onCommentModerated",
        "description": "Log moderation actions",
        "compatibleWith": [
          "@radzor/log-aggregator.action.info.message",
          "@radzor/event-tracker.action.track.eventName"
        ]
      }
    ]
  }
}

@radzor/comment-system

Install

Inputs

Outputs

Actions

Events

Composability

radzor.manifest.json