Skip to content

docs(sse): document SSE directive for v1.20.0 - #69

Merged
ErickXavier merged 1 commit into
mainfrom
docs/NOJS-270-NOJS-277
Jul 17, 2026
Merged

docs(sse): document SSE directive for v1.20.0#69
ErickXavier merged 1 commit into
mainfrom
docs/NOJS-270-NOJS-277

Conversation

@ErickXavier

Copy link
Copy Markdown
Collaborator

What changed

SSE (Server-Sent Events) directive documentation synced from Core implementation (NOJS-270 initiative, task NOJS-277).

Context

  • Initiative: NOJS-270 (SSE directive, v1.20.0)
  • Task: NOJS-277 -- Skill sync

Changes

SKILL.md

  • Added SSE cheat-sheet section under HTTP / Data Fetching with attribute table covering all 9 attributes
  • Included compact live-feed example demonstrating sse-insert, sse-limit, $sse state, and error template
  • Added sse.md entry to the Reference File Map

references/directives/sse.md (new)

  • Full attribute API with defaults, types, and examples
  • $sse connection state object with state transition table
  • Data parsing (JSON with raw-string fallback)
  • Reactive URL behavior (close + reopen on change, array reset)
  • Authentication limitations (no custom headers; query tokens or cookies via sse-credentials)
  • Connection limit tracking and HTTP/1.1 6-connection warning
  • Disposal and cleanup (Safety Rules 1, 2, disconnection guards, watcher cleanup)

All claims cross-referenced against the actual src/directives/sse.js implementation on origin/feat/NOJS-270.

Files modified

  • nojs/SKILL.md
  • nojs/references/directives/sse.md (new)

…nces

Add SSE (Server-Sent Events) directive documentation for the v1.20.0
release. SKILL.md gets a cheat-sheet section with attribute table and
live-feed example. New references/directives/sse.md covers the full
attribute API, $sse connection state, data parsing, reactive URLs,
authentication limitations, connection limits, and disposal semantics.
@ErickXavier
ErickXavier merged commit 2510adf into main Jul 17, 2026
1 check passed
@ErickXavier
ErickXavier deleted the docs/NOJS-270-NOJS-277 branch July 17, 2026 12:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant