next-action-forge 0.2.7 → 0.2.8

package/README.md

@@ -155,6 +155,57 @@ export const updateProfile = authClient
   });
 ```
 
+### Server-Driven Redirects
+
+Define redirects that execute automatically after successful actions:
+
+```typescript
+// Simple redirect
+export const logoutAction = actionClient
+  .redirect("/login")
+  .action(async () => {
+    await clearSession();
+    return { message: "Logged out successfully" };
+  });
+
+// Redirect with configuration
+export const deleteAccountAction = actionClient
+  .redirect({ 
+    url: "/goodbye", 
+    replace: true,    // Use router.replace instead of push
+    delay: 2000       // Delay redirect by 2 seconds
+  })
+  .action(async () => {
+    await deleteUserAccount();
+    return { deleted: true };
+  });
+
+// Conditional redirect based on result
+export const updateProfileAction = actionClient
+  .redirect((result) => result.needsVerification ? "/verify" : "/profile")
+  .inputSchema(profileSchema)
+  .action(async (input) => {
+    const user = await updateUser(input);
+    return { 
+      user, 
+      needsVerification: !user.emailVerified 
+    };
+  });
+```
+
+Client-side usage:
+
+```tsx
+const { execute } = useServerAction(logoutAction, {
+  onSuccess: (data) => {
+    // This runs BEFORE the redirect
+    toast.success("Logged out successfully");
+  },
+  preventRedirect: true,  // Optionally prevent automatic redirect
+  redirectDelay: 1000,    // Global delay for all redirects
+});
+```
+
 ### Form Actions
 
 ```typescript
@@ -442,6 +493,7 @@ client
   .inputSchema(zodSchema)   // Set input validation schema
   .outputSchema(zodSchema)  // Set output validation schema
   .onError(handler)         // Set error handler
+  .redirect(config)         // Set redirect on success
   .action(serverFunction)   // Define the server action
   .formAction(serverFunction) // Define a form action
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "next-action-forge",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "description": "A simple, type-safe toolkit for Next.js server actions with Zod validation",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",