HintRejection

enum HintRejection

Declared in Sources/PrismCore/Probe/SourceOpenHints.swift · PrismCore 3.5.4

Why a hint, or a whole set of them, was not used.

A rejection is not an error: the open proceeds exactly as it does without hints. It is reported so a host can measure how often the trust rules fire — a rejection rate above the noise floor means a validator policy or a producer-version policy is wrong, and that is worth knowing before it is worth optimising.

Cases

validatorUnavailable source

case validatorUnavailable

The transport reported no validator at all, so nothing could be bound to the representation. Sizing hints survive this; a map does not.

validatorMismatch(expected:reported:)source

case validatorMismatch(expected: String, reported: String)

The transport's validator is not the one the caller expected. The bytes being read are some other version of the resource.

validatorNotRequested source

case validatorNotRequested

A map was supplied without expectedValidator. Refused by rule rather than by circumstance: a map consumed on the catalog binding alone is the one failure mode worse than making no use of hints at all.

streamMismatch(supplied:)source

case streamMismatch(supplied: Int32)

streamIndex does not name a video stream in the opened source.

timeBaseMismatch(supplied:actual:)source

case timeBaseMismatch(supplied: String, actual: String)

The map's time base is not the stream's. A mismatch means the identity the map was keyed by described a different file.

malformedMap(_:)source

case malformedMap(String)

Fewer than two timestamps, not strictly increasing, or past the cap.

outOfBounds(_:)source

case outOfBounds(String)

A timestamp falls outside the stream's start and the container's duration.

Generated from the public symbols of PrismCore 3.5.4. All types