Validate a string against the AdCP 3.1 adcp_version wire pattern.
Throws ConfigurationError with a hint that points at
toReleasePrecisionWire when the value would be sent on the wire
but doesn't satisfy core/version-envelope.json's pattern.
Use this when you're constructing a request envelope by hand (storyboard
fixtures, conformance harnesses, custom transports) and want a clear
error rather than a downstream AJV pattern-mismatch from the seller —
by the time the seller rejects the request, the buyer's stack frame is
long gone and core/version-envelope.json/properties/adcp_version/pattern
is the only clue.
The SDK's own buildVersionEnvelope calls this as a postcondition after
normalizing the bundle key — should never throw in well-formed SDK code,
but if a future refactor breaks the normalization the assertion fires
with a message that names the helper to call.
Returns the value with the type narrowed to string via assertion.
Validate a string against the AdCP 3.1
adcp_versionwire pattern. ThrowsConfigurationErrorwith a hint that points at toReleasePrecisionWire when the value would be sent on the wire but doesn't satisfycore/version-envelope.json's pattern.Use this when you're constructing a request envelope by hand (storyboard fixtures, conformance harnesses, custom transports) and want a clear error rather than a downstream AJV pattern-mismatch from the seller — by the time the seller rejects the request, the buyer's stack frame is long gone and
core/version-envelope.json/properties/adcp_version/patternis the only clue.The SDK's own
buildVersionEnvelopecalls this as a postcondition after normalizing the bundle key — should never throw in well-formed SDK code, but if a future refactor breaks the normalization the assertion fires with a message that names the helper to call.Returns the value with the type narrowed to
stringvia assertion.