Skip to content

[#553] Always include a bdSeq number for scoping messages to a session - #619

Merged
wes-johnson merged 1 commit into
eclipse-sparkplug:developfrom
wes-johnson:553-bdseq-session-scoping
Aug 10, 2026
Merged

wes-johnson merged 1 commit into
eclipse-sparkplug:developfrom
wes-johnson:553-bdseq-session-scoping

Conversation

@wes-johnson

Copy link
Copy Markdown
Contributor

Require bd_seq in every message an Edge Node publishes, so any single message can be attributed to the session that produced it. Adds *-bdseq statements for NDATA, NRESP, DBIRTH, DREBIRTH, DDATA, DRESP, and DDEATH.

Corrects two blocking defects:

  • payloads-bd-sequence-num-included named only NBIRTH/NREBIRTH/NDEATH and did not cover the NMETA/NMMETA/DMETA/DMMETA that Ch4 already required.
  • payloads-bd-sequence-num-incrementing described seq behavior (increment per message), contradicting topics-nbirth-bdseq-increment and operational-behavior-rebirth-action-3. Now increments per MQTT CONNECT.

Adds payloads-bd-sequence-num-session-constant for the session invariant, renames the mislabelled seq payload field description to bd_seq, and adds host-partial-bdseq-scope and host-partial-bdseq-new-session so a partial-subscription Host Application can scope a message to a session without having observed the BIRTH sequence that opened it.

Also normalizes 696 non-breaking spaces used as indentation in Ch6 example payloads; all 15 example payloads now parse as valid JSON.

…sages to a session

Require bd_seq in every message an Edge Node publishes, so any single
message can be attributed to the session that produced it. Adds *-bdseq
statements for NDATA, NRESP, DBIRTH, DREBIRTH, DDATA, DRESP, and DDEATH.

Corrects two blocking defects:
- payloads-bd-sequence-num-included named only NBIRTH/NREBIRTH/NDEATH and
  did not cover the NMETA/NMMETA/DMETA/DMMETA that Ch4 already required.
- payloads-bd-sequence-num-incrementing described seq behavior (increment
  per message), contradicting topics-nbirth-bdseq-increment and
  operational-behavior-rebirth-action-3. Now increments per MQTT CONNECT.

Adds payloads-bd-sequence-num-session-constant for the session invariant,
renames the mislabelled _seq_ payload field description to _bd_seq_, and
adds host-partial-bdseq-scope and host-partial-bdseq-new-session so a
partial-subscription Host Application can scope a message to a session
without having observed the BIRTH sequence that opened it.

Also normalizes 696 non-breaking spaces used as indentation in Ch6 example
payloads; all 15 example payloads now parse as valid JSON.
@wes-johnson
wes-johnson merged commit ed2470b into eclipse-sparkplug:develop Aug 10, 2026
1 check passed
@wes-johnson
wes-johnson deleted the 553-bdseq-session-scoping branch August 31, 2026 15:15
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