Enable coercion of trapped values

[benjie]

Description

trap($step, TRAP_ERROR, { valueForError: "NULL" | "EMPTY_LIST" | "PASS_THROUGH" })

When you trap an error or inhibited, you may want to have the value be replaced, either with NULL or EMPTY_LIST. Also, when trapping an error if you just keep it as an error it will immediately be turned back into an error again 🤦‍♂️ so we now wrap it in TrappedError (which does not inherit from Error and thus is treated as a value).

Performance impact

Unknown.

Security impact

None known.

Checklist

• My code matches the project's code style and yarn lint:fix passes.
• I've added tests for the new feature, and yarn test passes.
• I have detailed the new feature in the relevant documentation.
• I have added this feature to 'Pending' in the RELEASE_NOTES.md file (if one exists).
• If this is a breaking change I've explained why.

[changeset-bot]

🦋 Changeset detected

Latest commit: 595fc08

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 15 packages

Name	Type
grafast	Patch
@localrepo/grafast-bench	Patch
@dataplan/json	Patch
@dataplan/pg	Patch
@grafserv/persisted	Patch
grafserv	Patch
ruru-components	Patch
@localrepo/grafast-website	Patch
graphile-build-pg	Patch
graphile-build	Patch
graphile-utils	Patch
pgl	Patch
postgraphile	Patch
graphile-export	Patch
graphile	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR