Skip to content

usubscription: explicitly require SubscriberInfo.uri.resource_id = 0 for subscriber identity #321

@PLeVasseur

Description

@PLeVasseur

Problem

During review of eclipse-uprotocol/up-streamer-rust#77, we hit ambiguity around subscriber URI examples used in subscription data (for example //authority-b/5678/1/1234).

Reviewer feedback suggested using resource 0x0000 for subscriber UUris for clarity. That appears consistent with endpoint semantics, but the current uSubscription text does not explicitly require it.

Relevant spec context

Gap

There is no explicit normative statement that SubscriberInfo.uri.resource_id must be 0, which leads to inconsistent examples and reviewer confusion.

Proposed change

Add explicit uSubscription requirement text that for SubscriberInfo.uri:

  • resource_id MUST be 0 (subscriber endpoint identity),
  • existing non-wildcard requirements remain in force.

Also update:

  • up-l3/usubscription/v3/README.adoc (normative text + examples),
  • up-core-api/uprotocol/core/usubscription/v3/usubscription.proto comments for SubscriberInfo.

Why

This removes ambiguity, aligns SubscriberInfo with established endpoint semantics, and improves interoperability/readability across implementations and tests.

Metadata

Metadata

Assignees

Labels

enhancementNew feature or request
No fields configured for Feature.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions