Skip to content

Encode empty-data SSE events as dispatchable events - #6975

Merged
tim-smart merged 2 commits into
mainfrom
audit/repro-unstable-encoding-sse-empty-data
Aug 5, 2026
Merged

Encode empty-data SSE events as dispatchable events#6975
tim-smart merged 2 commits into
mainfrom
audit/repro-unstable-encoding-sse-empty-data

Conversation

@fubhy

@fubhy fubhy commented Aug 4, 2026

Copy link
Copy Markdown
Member

Summary

Encoding and reparsing an accepted event whose data is the empty string produces no event.

Important

This PR starts with focused failing reproduction tests. Add the implementation fix to this same branch; CI is expected to fail until that fix is included.

SSE encoder drops empty-data events

Module: encoding/Sse
Audit ID: unstable-ai-cli-sse-empty-data-event-dropped
Severity / confidence: medium / high

What happens

Encoding and reparsing an accepted event whose data is the empty string produces no event.

Why it happens

The encoder omits data: for empty data and writes only a blank terminator, which the parser ignores while its data buffer is empty.

Expected behavior

Every accepted Event, including data equal to the empty string, renders as an SSE event that can be dispatched.

Relevant implementation

These links and excerpts are pinned to audit base c9b56ab507f224426ee8388dc450da447ec4715f.

View problematic code at packages/effect/src/unstable/encoding/Sse.ts:654-669
export const encoder: Encoder = {
  write(event: AnyEvent): string {
    switch (event._tag) {
      case "Event": {
        let data = ""
        if (event.id !== undefined) {
          data += `id: ${event.id}\n`
        }
        if (event.event !== "message") {
          data += `event: ${event.event}\n`
        }
        if (event.data !== "") {
          data += `data: ${event.data.replace(/\n/g, "\ndata: ")}\n`
        }
        return data + "\n"
      }

View exact lines on GitHub

Reproduction

pnpm test --run packages/effect/test/unstable/encoding/Sse.test.ts

Observed failure: FAIL: the round-trip produced no event.

Implementation handoff

The initial reproduction tests on this branch are the regression specification for the implementation fix that should follow in this PR.

  1. Start with the pinned implementation excerpts and the Why it happens analysis above.
  2. Change the implementation so it satisfies the stated Expected behavior; do not weaken or remove the reproduction assertions.
  3. Run the focused reproduction command(s) and confirm the observed failures become passing tests:
pnpm test --run packages/effect/test/unstable/encoding/Sse.test.ts
  1. Run the affected package's existing tests, then the repository lint and type checks before requesting review.

Audit provenance

  • Audit base: c9b56ab507f224426ee8388dc450da447ec4715f
  • Reproduction base: c9b56ab507f224426ee8388dc450da447ec4715f
  • Findings: unstable-ai-cli-sse-empty-data-event-dropped
  • Initial patch: focused reproduction tests; implementation fix pending

Closes EFF-416

@fubhy fubhy added the audit Findings originating from the Effect runtime correctness audit label Aug 4, 2026
@changeset-bot

changeset-bot Bot commented Aug 4, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 8ee0d59

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 30 packages
Name Type
effect Patch
@effect/ai-anthropic Patch
@effect/ai-openai Patch
@effect/ai-openai-compat Patch
@effect/ai-openrouter Patch
@effect/atom-react Patch
@effect/atom-solid Patch
@effect/atom-vue Patch
@effect/docgen Patch
@effect/doctest Patch
@effect/openapi-generator Patch
@effect/opentelemetry Patch
@effect/platform-browser Patch
@effect/platform-bun Patch
@effect/platform-deno Patch
@effect/platform-node Patch
@effect/platform-node-shared Patch
@effect/sql-clickhouse Patch
@effect/sql-d1 Patch
@effect/sql-libsql Patch
@effect/sql-mssql Patch
@effect/sql-mysql2 Patch
@effect/sql-pg Patch
@effect/sql-pglite Patch
@effect/sql-sqlite-bun Patch
@effect/sql-sqlite-do Patch
@effect/sql-sqlite-node Patch
@effect/sql-sqlite-react-native Patch
@effect/sql-sqlite-wasm Patch
@effect/vitest Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@effect-slopcop effect-slopcop Bot added 4.0 bug Something isn't working labels Aug 4, 2026

@pullfrog pullfrog Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Important

This PR lands the regression test, but the implementation fix described in the title and PR body is still missing. The test correctly fails until the encoder change is added.

Reviewed changes

  • Added a single regression round-trip test in packages/effect/test/unstable/encoding/Sse.test.ts that verifies an Event with data: "" round-trips through Sse.encoder and Sse.makeParser.

⚠️ Implementation fix is required before merge

The diff currently only adds the failing test. Sse.encoder at packages/effect/src/unstable/encoding/Sse.ts:665 still skips the data: field when event.data === "", so the event dispatches nothing. To satisfy the expected behavior stated in the PR body, remove the if (event.data !== "") guard so an empty data value still emits data: and makeParser will dispatch it.

⚠️ Changeset needed

Because the eventual fix changes runtime encoding behavior, add a changeset under .changeset/ before merging.

Pullfrog  | ⚠️ this action is pinned to a commit SHA, which freezes the cleanup step — switch to @v0 or keep the SHA fresh with Dependabot | Fix it ➔View workflow run | Using Kimi K2 (free via Pullfrog for OSS) | 𝕏

@pullfrog pullfrog Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ No new issues found.

Reviewed changes

  • Removed the if (event.data !== "") guard in packages/effect/src/unstable/encoding/Sse.ts so an empty data value still emits a data: line and makeParser dispatches the event.
  • Added a changeset under .changeset/empty-geckos-dispatch.md describing the patch-level runtime behavior change.
  • The regression test added in the previous commit now passes.

Pullfrog  | ⚠️ this action is pinned to a commit SHA, which freezes the cleanup step — switch to @v0 or keep the SHA fresh with Dependabot | View workflow run | Using Kimi K2 (free via Pullfrog for OSS) | 𝕏

@tim-smart
tim-smart force-pushed the audit/repro-unstable-encoding-sse-empty-data branch from 232cca3 to d9cc206 Compare August 4, 2026 23:31
@tim-smart
tim-smart enabled auto-merge (squash) August 4, 2026 23:33
@github-actions

github-actions Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Bundle Size Analysis

Generated from PR build output; treat the content below as untrusted.

File Name Current Size Previous Size Difference
basic.ts 7.06 KB 7.06 KB 0.00 KB (0.00%)
batching.ts 9.86 KB 9.86 KB 0.00 KB (0.00%)
brand.ts 6.34 KB 6.34 KB 0.00 KB (0.00%)
cache.ts 10.71 KB 10.71 KB 0.00 KB (0.00%)
config.ts 20.60 KB 20.60 KB 0.00 KB (0.00%)
differ.ts 20.20 KB 20.20 KB 0.00 KB (0.00%)
http-client.ts 21.53 KB 21.53 KB 0.00 KB (0.00%)
logger.ts 10.84 KB 10.84 KB 0.00 KB (0.00%)
metric.ts 8.98 KB 8.98 KB 0.00 KB (0.00%)
optic.ts 7.18 KB 7.18 KB 0.00 KB (0.00%)
pubsub.ts 14.99 KB 14.99 KB 0.00 KB (0.00%)
queue.ts 11.66 KB 11.66 KB 0.00 KB (0.00%)
schedule.ts 10.83 KB 10.83 KB 0.00 KB (0.00%)
schema-class.ts 19.14 KB 19.14 KB 0.00 KB (0.00%)
schema-fromJsonSchemaDocument.ts 28.96 KB 28.96 KB 0.00 KB (0.00%)
schema-representation-roundtrip.ts 25.29 KB 25.29 KB 0.00 KB (0.00%)
schema-string-transformation.ts 13.38 KB 13.38 KB 0.00 KB (0.00%)
schema-string.ts 10.94 KB 10.94 KB 0.00 KB (0.00%)
schema-template-literal.ts 15.17 KB 15.17 KB 0.00 KB (0.00%)
schema-toArbitraryLazy.ts 21.94 KB 21.94 KB 0.00 KB (0.00%)
schema-toCodeDocument.ts 24.34 KB 24.34 KB 0.00 KB (0.00%)
schema-toCodecJson.ts 19.18 KB 19.18 KB 0.00 KB (0.00%)
schema-toEquivalence.ts 19.01 KB 19.01 KB 0.00 KB (0.00%)
schema-toFormatter.ts 18.87 KB 18.87 KB 0.00 KB (0.00%)
schema-toJsonSchemaDocument.ts 22.60 KB 22.60 KB 0.00 KB (0.00%)
schema-toRepresentation.ts 19.52 KB 19.52 KB 0.00 KB (0.00%)
schema.ts 18.41 KB 18.41 KB 0.00 KB (0.00%)
stm.ts 12.63 KB 12.63 KB 0.00 KB (0.00%)
stream.ts 9.80 KB 9.80 KB 0.00 KB (0.00%)

@pullfrog pullfrog Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ No new issues found.

Reviewed changes

The new head rebases the previously approved fix onto latest main and splits it into two commits without changing the net diff:

  • Removed the if (event.data !== "") guard in packages/effect/src/unstable/encoding/Sse.ts so an empty data value still emits a data: line and makeParser dispatches the event.
  • Added a regression test in packages/effect/test/unstable/encoding/Sse.test.ts that verifies an Event with data: "" round-trips through Sse.encoder and Sse.makeParser.
  • Added a changeset under .changeset/empty-geckos-dispatch.md describing the patch-level runtime behavior change.

Validation run: pnpm --filter effect test --run test/unstable/encoding/Sse.test.ts, pnpm lint-fix, and pnpm check all pass.

Pullfrog  | ⚠️ this action is pinned to a commit SHA, which freezes the cleanup step — switch to @v0 or keep the SHA fresh with Dependabot | View workflow run | Using Kimi K2 (free via Pullfrog for OSS) | 𝕏

@tim-smart
tim-smart force-pushed the audit/repro-unstable-encoding-sse-empty-data branch from d9cc206 to 8ee0d59 Compare August 5, 2026 00:03
@tim-smart
tim-smart merged commit abcbb2a into main Aug 5, 2026
18 of 19 checks passed
@tim-smart
tim-smart deleted the audit/repro-unstable-encoding-sse-empty-data branch August 5, 2026 00:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

4.0 audit Findings originating from the Effect runtime correctness audit bug Something isn't working

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants