dunglas / mercure / 29599463785

86%

master: 93%

Build Type

push

github

Committed by web-flow

Commit Message

feat!: OAuth 2.0 authorization, Exact/URLPattern matchers, and docs (#1278)

* feat(matcher): add MatcherType enum and go-urlpattern

Scaffolding for the Exact + URLPattern matcher types defined by the
spec revision (https://github.com/dunglas/mercure/pull/1262). The enum
replaces the matcher registry explored in
https://github.com/dunglas/mercure/pull/1207.

Refs https://github.com/dunglas/mercure/pull/1262

* feat(matcher): switch-based Exact and URLPattern matching

TopicSelectorStore dispatches on MatcherType instead of a registry:
Exact is a plain slices.Contains, URLPattern compiles via go-urlpattern
with the hub URL as base (ignoreCase off, per spec). v8 exact-or-URI-
Template matching moves behind the new deprecated_topic build tag.

The legacy match() path is kept temporarily until subscribers and
claims migrate to topicMatcher.

Refs https://github.com/dunglas/mercure/pull/1262

* feat(update)!: single canonical Topic per update

Update.Topics becomes Update.Topic: the spec revision removes alternate
topics (an update has exactly one). The v8 Topics field survives behind
the deprecated_topic build tag as alternate topics, and a custom JSON
codec keeps the historic "Topics" array wire shape so bolt databases
written by 0.x hubs stay readable.

BREAKING CHANGE: Go API users must set Update.Topic. Update.Topics
exists only in deprecated_topic builds.

Refs https://github.com/dunglas/mercure/pull/1262

* feat(matcher)!: topic and topicURLPattern subscribe parameters

Implements the matcher surface of the spec revision: the topic query
parameter selects Exact matching, topicURLPattern selects WHATWG URL
Pattern matching, and unknown matcher parameter names are rejected with
a 400. JWT mercure.publish / mercure.subscribe entries use the object
form {match, matchType, payload} with matchType defaulting to Exact;
the per-subscription payload is the first matching subscribe claim's
payload. The subscription API moves to
/subscriptions/{matchType}/{ma... (continued)

Coverage Stats

1116 of 1255 new or added lines in 28 files covered. (88.92%)

17 existing lines in 6 files now uncovered.

2712 of 3189 relevant lines covered (85.04%)

101.0 hits per line