Home / softtor / nestjs-hexagonal · skills/websocket-broadcasting/SKILL.md · GitHub

websocket-broadcasting skillA

websocket-broadcasting is agent-read markdown (skill) from softtor/nestjs-hexagonal: Use when broadcasting domain events to the frontend via WebSocket (Socket.IO). Covers WsGatewayPort abstraction, gateway with Redis adapter, JWT auth, room-based multi-tenant isolation, and frontend consumption. One simple pattern — no over-engineering..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# WebSocket Broadcasting

Broadcasts domain events to connected frontend clients via Socket.IO. Simple pattern: `@EventsHandler` -> enrich if needed -> `WsGatewayPort.emit()`.

---

## Flow

```
Entity.apply(event)           <- domain (queued)
  -> entity.commit()          <- handler (dispatch via EventBus)
    -> @EventsHandler         <- bridge handler
      -> (optional) repo.findById() to enrich payload
      -> gateway.emitToOrganization(orgId, event, data)
        -> Socket.IO server.to(`org:${orgId}`).emit()
          -> Redis Pub/Sub (multi-pod)
            -> connected clients
```

---

## 1. WsGatewayPort (hexagonal abstraction)

Define in `shared/ports/` or the BC's `application/ports/`:

```typescript
export const WS_GATEWAY_TOKEN = Symbol('WsGateway');

export interface WsGatewayPort {
  emitToOrganization(orgId: string, event: string, data: Record<string, unknown>): void;
  emitToUser(userId: string, event: string, data: Record<string, unknown>): void;
  emitGlobal(event: string, data: Record<string, unknown>): void;
}
```

Register in module: `{ provide: WS_GATEWAY_TOKEN, useExisting: AppGateway }`
…

Read the whole file at its exact version.

How to install

Latest version
mdr add softtor/nestjs-hexagonal/websocket-broadcasting@git:20260327.3ac41d8
Exact content
mdr add softtor/nestjs-hexagonal/websocket-broadcasting@sha256:2303f75fc0374e89

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_xbswmsvkabi5rnna.svg)](https://markdownregistry.com/a/art_xbswmsvkabi5rnna)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260327.3ac41d8 latest2026-03-27 3ac41d8 5,737 BA view · diff
git:20260327.26943982026-03-27 2694398 5,652 BA view · diff
git:20260326.a4e1dae2026-03-26 a4e1dae 5,572 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (5737 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

softtor/nestjs-hexagonal · 5 stars · license MIT · pushed 2026-09-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_xbswmsvkabi5rnna
GET https://markdownregistry.com/api/v1/resolve?ref=softtor/nestjs-hexagonal/websocket-broadcasting
GET https://markdownregistry.com/api/v1/blob/2303f75fc0374e892dc7c59b6f668100e3ae47b2d52430f421807f6d49893754

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from softtor/nestjs-hexagonal

CLAUDE.md claude
softtor/nestjs-hexagonal · CLAUDE.md
git:20260923.1229e8e · audit A · 5 stars
application skill
softtor/nestjs-hexagonal · skills/application/SKILL.md · Use when creating application layer artifacts for a NestJS bounded context — use cases, CQRS command/query handlers…
git:20260920.ed50a26 · audit A · 5 stars
create-subdomain skill
softtor/nestjs-hexagonal · skills/create-subdomain/SKILL.md · Orchestrates creation of a NestJS bounded context by dispatching specialized agents per layer (domain, application…
git:20260923.1229e8e · audit A · 5 stars
domain skill
softtor/nestjs-hexagonal · skills/domain/SKILL.md · Use when creating domain layer artifacts for a NestJS bounded context — entities (AggregateRoot), value objects, domain…
git:20260327.3ac41d8 · audit A · 5 stars
event-listeners skill
softtor/nestjs-hexagonal · skills/event-listeners/SKILL.md · Use when creating event listeners that react to domain events — same-BC side effects (projections, audit, cache)…
git:20260327.7ebc591 · audit A · 5 stars
gsd-installer skill
softtor/nestjs-hexagonal · skills/gsd-installer/SKILL.md · Configures a NestJS project to use the nestjs-hexagonal plugin with GSD workflow. Adds skill references to CLAUDE.md…
git:20260923.1229e8e · audit A · 5 stars
infrastructure skill
softtor/nestjs-hexagonal · skills/infrastructure/SKILL.md · Use when creating infrastructure layer artifacts for a NestJS bounded context — Prisma repositories, in-memory…
git:20260921.8a9939b · audit A · 5 stars
jev-eval skill
softtor/nestjs-hexagonal · skills/jev-eval/SKILL.md · Calibrates or evaluates a semantic (Jev) rule of the nestjs-hexagonal rulebook — adds labelled golden cases, runs the…
git:20260921.98d05f3 · audit A · 5 stars
onboard-project skill
softtor/nestjs-hexagonal · skills/onboard-project/SKILL.md · Onboards a NestJS project to the nestjs-hexagonal rulebook, CLI and hooks — creates .claude/rulebook.yaml extending the…
git:20260921.98d05f3 · audit A · 5 stars
presentation skill
softtor/nestjs-hexagonal · skills/presentation/SKILL.md · Use when creating presentation layer artifacts for a NestJS bounded context — REST controllers, request DTOs with…
git:20260921.8a9939b · audit A · 5 stars
review-subdomain skill
softtor/nestjs-hexagonal · skills/review-subdomain/SKILL.md · Reviews a NestJS bounded context for Hexagonal Architecture + DDD + CQRS compliance in three steps — static rulebook…
git:20260923.1229e8e · audit A · 5 stars
using-nestjs-hexagonal skill
softtor/nestjs-hexagonal · skills/using-nestjs-hexagonal/SKILL.md · Meta-skill that routes NestJS development tasks to the correct nestjs-hexagonal skill or agent. Activates when working…
git:20260923.1229e8e · audit A · 5 stars

Every file in softtor/nestjs-hexagonal

Browse by kind, by grade A, or by owner.