Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Simplify step returns such that JsonifyObject<> is hidden entirely #371

Merged
merged 3 commits into from
Oct 25, 2023

Conversation

jpwilliams
Copy link
Member

@jpwilliams jpwilliams commented Oct 24, 2023

Summary

Step results are serialized and deserialized while being pushed to/from Inngest, so step returns are typed as JSON to make this clear.

These returns still came back wrapped in JsonifyObject<>, though, meaning they didn't actually show the resulting changes unless the user started to attempt to use them. This small change ensures we display the resulting type correctly, free of any wrappers.

image image
Before After

Checklist

  • Added a docs PR that references this PR N/A
  • Added unit/integration tests N/A
  • Added changesets if applicable

@jpwilliams jpwilliams added prerelease/inngest Create snapshot releases for a PR for the "inngest" package. 🧑‍💻 dx Dev-facing resources such as examples or READMEs labels Oct 24, 2023
@jpwilliams jpwilliams self-assigned this Oct 24, 2023
@changeset-bot
Copy link

changeset-bot bot commented Oct 24, 2023

🦋 Changeset detected

Latest commit: 4746da6

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

This PR includes changesets to release 1 package
Name Type
inngest 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

@inngest-release-bot
Copy link
Collaborator

inngest-release-bot commented Oct 24, 2023

A user has added the prerelease/inngest label, so this PR will be published to npm with the tag pr-371. It will be updated with the latest changes as you push commits to this PR.

You can install this prerelease version with:

npm install inngest@pr-371

The last release was built and published from 4746da6.

@jpwilliams jpwilliams merged commit d45bfbd into main Oct 25, 2023
21 checks passed
@jpwilliams jpwilliams deleted the types/simplify-step-returns branch October 25, 2023 16:11
jpwilliams added a commit that referenced this pull request Oct 26, 2023
## Summary
<!-- Succinctly describe your change, providing context, what you've
changed, and why. -->


[`BigInt`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigInt)s
are not natively parsed by JSON. Attempting to return a `BigInt` from a
step or function will throw an error. This error was hard to see, which
is fixed in #374.

Our types reflect that `BigInt` is unparseable and will type it as
`never`, though these were obscured from the user a touch, which is
fixed in #371.

For this reason, this PR ensures `BigInt`s are removed during parsing
instead of throwing. We can investigate adding `BigInt` support across
our SDKs past this fix; the `n` suffix seems an unwritten standard.

## Checklist
<!-- Tick these items off as you progress. -->
<!-- If an item isn't applicable, ideally please strikeout the item by
wrapping it in "~~"" and suffix it with "N/A My reason for skipping
this." -->
<!-- e.g. "- [ ] ~~Added tests~~ N/A Only touches docs" -->

- [ ] ~~Added a [docs PR](https://github.com/inngest/website) that
references this PR~~ N/A
- [x] Added unit/integration tests
- [x] Added changesets if applicable

## Related

- #371
- #374
jpwilliams pushed a commit that referenced this pull request Oct 26, 2023
This PR was opened by the [Changesets
release](https://github.com/changesets/action) GitHub action. When
you're ready to do a release, you can merge this and the packages will
be published to npm automatically. If you're not ready to do a release
yet, that's fine, whenever you add more changesets to main, this PR will
be updated.


# Releases
## [email protected]

### Patch Changes

- [#371](#371)
[`d45bfbd`](d45bfbd)
Thanks [@jpwilliams](https://github.com/jpwilliams)! - Remove
`JsonifyObject<>` wrapper from step output - it's now clearer to see the
actual type of a step's result

- [#375](#375)
[`e19f9b4`](e19f9b4)
Thanks [@jpwilliams](https://github.com/jpwilliams)! - Fix failing to
parse `BigInt` during step/function result serialization; it is now
correctly typed and returned as `never`

- [#374](#374)
[`dcafc2b`](dcafc2b)
Thanks [@jpwilliams](https://github.com/jpwilliams)! - Fixed an issue
where an error log wasn't shown if execution result parsing failed, such
as in the case of serialization failures

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
🧑‍💻 dx Dev-facing resources such as examples or READMEs prerelease/inngest Create snapshot releases for a PR for the "inngest" package.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants