next-safe-action/next-safe-action
Next Safe Action
This library provides a framework for building type-safe server actions within Next.js, focusing on end-to-end validation and structured communication between the client and server. It wraps standard server functions to inject schema-based input validation, ensuring that only correctly formatted data reaches backend logic while providing consistent, typed error reporting for client-side consumption.
The project distinguishes itself through a robust middleware orchestration system that allows developers to execute sequences of logic—such as authentication, logging, or data transformation—before or after an action runs. It also includes built-in support for optimistic user interface updates, enabling immediate state changes in the browser with automatic rollbacks if a server request fails.
Beyond core execution, the framework manages the full lifecycle of server-side operations through reactive hooks. These tools synchronize form states, track execution status, and automatically update client-side data caches once an action completes. By enforcing schema compliance at both compile time and runtime, the library prevents malformed data from triggering backend errors and simplifies the management of complex, asynchronous application workflows.
Features
- Server Action Integrations - Provides a framework for building type-safe server actions within Next.js with end-to-end validation and structured communication.
- Server Actions - Wraps standard server functions to inject validation, error reporting, and lifecycle tracking.
- End-to-End - Ensures end-to-end type safety by propagating schema definitions across the client-server boundary.
- Input Validation Schemas - Enforces strict type checking on incoming request data using external schema definitions.
- Input Validation Schemas - Validates input schemas against predefined structures before processing server action logic.
- Schema-Based Action Validators - Validates server action inputs using schema-based rules to ensure type safety and prevent malformed data execution.
- Type-Safe Definitions - Defines type-safe server actions that enforce structured error handling and schema compliance for client-side invocation.
- State Management Hooks - Provides reactive hooks to track server action lifecycles and synchronize UI state.
- Result Types - Encapsulates server-side execution outcomes into structured, typed result objects.
- State Action Generators - Provides reactive hooks to manage action state, including pending, success, and failure callbacks within components.
- Server-Side Authorization - Verifies user sessions and permissions within server actions to protect sensitive logic.
- Action Lifecycle Middleware - Hooks into the lifecycle of server actions to track execution status and report transitions before UI updates.
- Data Schema Enforcement - Enforces metadata schema validation to prevent runtime crashes from malformed data structures.
- Validation Error Reporters - Reports validation errors with structured, type-safe messages to simplify debugging on the client side.
- Build-Time Metadata Validators - Enforces metadata schema validation at compile time to prevent runtime errors.
- Form Handling - Synchronizes form state between client inputs and server-side validation logic.
- Type-Safe Form Submissions - Connects client-side form submissions to server-side processing with automatic validation.
- Server Action Form Wrappers - Integrates server-side logic directly with form submissions for seamless data processing.
- Form State Management - Synchronizes client-side form submissions with server-side validation and manages optimistic UI state.
- Middleware Chains - Processes requests through modular middleware chains to handle authentication and context preparation.
- Middleware Composition Layers - Enables the composition of middleware sequences to prepare request data and context before server action execution.
- Middleware Orchestration - Provides a library for orchestrating middleware sequences before server action execution.
- Optimistic UI Updates - Enables immediate UI updates during server actions with automatic rollbacks if the request fails.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
