Actions: Make .safe() the default return value

[bholmesdev]

Changes

Make .safe() the default return value for actions. This means { data, error } will be returned when calling an action directly. If you prefer to get the data while allowing errors to throw, chain the .orThrow() modifier.

import { actions } from 'astro:actions';

// Before
const { data, error } = await actions.like.safe();
// After
const { data, error } = await actions.like();

// Before
const newLikes = await actions.like();
// After
const newLikes = await actions.like.orThrow();

• Update types and implementation to reverse this pattern
• Remove support for using unsafe action calls with React 19. Chaining .orThrow() will remove progressive enhancement, since exceptions must be caught on the client.

Testing

Update test fixtures to use the new API pattern.

Docs

RFC updates to be pushed on minor release

[changeset-bot]

🦋 Changeset detected

Latest commit: 05b163f

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

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

[github-actions]

This PR is blocked because it contains a minor changeset. A reviewer will merge this at the next release if approved.

no longer minor

[Princesseuh]

Does this interact in any way with this issue? #11515

[bholmesdev]

@Princesseuh Taking a look at that issue. This is switching a default, but wouldn't affect parsing behavior, so I don't believe so.