server-act 1.6.1 → 1.7.0

package/README.md

@@ -71,7 +71,7 @@ import { z } from "zod";
 export const sayHelloAction = serverAct
   .middleware(() => {
     const t = i18n();
-    const userId = "..."
+    const userId = "...";
     return { t, userId };
   })
   .input((ctx) => {
@@ -85,6 +85,39 @@ export const sayHelloAction = serverAct
   });
 ```
 
+#### Chaining Middlewares
+
+You can chain multiple middlewares by calling `.middleware(...)` repeatedly.
+
+- Middlewares run in registration order.
+- Each middleware receives the current `ctx` and can return additional context.
+- Returned objects are shallow-merged into `ctx`.
+- Later middleware values override earlier values for the same key.
+- Errors thrown in middleware propagate and stop later middleware from running.
+
+```ts
+// action.ts
+"use server";
+
+import { serverAct } from "server-act";
+
+export const createGreetingAction = serverAct
+  .middleware(() => ({
+    requestId: crypto.randomUUID(),
+    role: "user",
+  }))
+  .middleware(({ ctx }) => ({
+    role: "admin", // overrides previous role
+    actorLabel: `${ctx.role}-actor`,
+  }))
+  .middleware(({ ctx }) => ({
+    trace: `${ctx.requestId}:${ctx.actorLabel}`,
+  }))
+  .action(async ({ ctx }) => {
+    return `${ctx.role} -> ${ctx.trace}`;
+  });
+```
+
 ### `useActionState` Support
 
 > `useActionState` Documentation:
@@ -99,9 +132,7 @@ import { serverAct } from "server-act";
 import { formDataToObject } from "server-act/utils";
 import { z } from "zod";
 
-function zodFormData<T extends z.ZodType>(
-  schema: T,
-): z.ZodPipe<z.ZodTransform<Record<string, unknown>, FormData>, T> {
+function zodFormData<T extends z.ZodType>(schema: T) {
   return z.preprocess<Record<string, unknown>, T, FormData>(
     (v) => formDataToObject(v),
     schema,
@@ -141,7 +172,7 @@ import { formDataToObject } from "server-act/utils";
 
 ```ts
 const formData = new FormData();
-formData.append('name', 'John');
+formData.append("name", "John");
 
 const result = formDataToObject(formData);
 // Result: { name: 'John' }
@@ -151,7 +182,7 @@ const result = formDataToObject(formData);
 
 ```ts
 const formData = new FormData();
-formData.append('user.name', 'John');
+formData.append("user.name", "John");
 
 const result = formDataToObject(formData);
 // Result: { user: { name: 'John' } }
@@ -166,9 +197,7 @@ import { serverAct } from "server-act";
 import { formDataToObject } from "server-act/utils";
 import { z } from "zod";
 
-function zodFormData<T extends z.ZodType>(
-  schema: T,
-): z.ZodPipe<z.ZodTransform<Record<string, unknown>, FormData>, T> {
+function zodFormData<T extends z.ZodType>(schema: T) {
   return z.preprocess<Record<string, unknown>, T, FormData>(
     (v) => formDataToObject(v),
     schema,

package/dist/{index.js → index.cjs}

@@ -1,28 +1,22 @@
-//#region rolldown:runtime
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
+let _standard_schema_utils = require("@standard-schema/utils");
+
+//#region src/internal/middleware.ts
+/**
+* Executes an array of middleware functions with the given initial context.
+*/
+async function executeMiddlewares(middlewares, initialCtx) {
+	let ctx = initialCtx && typeof initialCtx === "object" ? { ...initialCtx } : {};
+	for (const middleware of middlewares) {
+		const result = await middleware({ ctx });
+		if (result && typeof result === "object") ctx = {
+			...ctx,
+			...result
+		};
 	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
+	return ctx;
+}
 
 //#endregion
-const __standard_schema_utils = __toESM(require("@standard-schema/utils"));
-
 //#region src/internal/schema.ts
 async function standardValidate(schema, input) {
 	let result = schema["~standard"].validate(input);
@@ -33,7 +27,7 @@ function getInputErrors(issues) {
 	const messages = [];
 	const fieldErrors = {};
 	for (const issue of issues) {
-		const dotPath = (0, __standard_schema_utils.getDotPath)(issue);
+		const dotPath = (0, _standard_schema_utils.getDotPath)(issue);
 		if (dotPath) if (fieldErrors[dotPath]) fieldErrors[dotPath].push(issue.message);
 		else fieldErrors[dotPath] = [issue.message];
 		else messages.push(issue.message);
@@ -46,20 +40,19 @@ function getInputErrors(issues) {
 
 //#endregion
 //#region src/index.ts
-const unsetMarker = Symbol("unsetMarker");
 function createNewServerActionBuilder(def) {
 	return createServerActionBuilder(def);
 }
 function createServerActionBuilder(initDef = {}) {
 	const _def = {
 		input: void 0,
-		middleware: void 0,
+		middleware: [],
 		...initDef
 	};
 	return {
 		middleware: (middleware) => createNewServerActionBuilder({
 			..._def,
-			middleware
+			middleware: [..._def.middleware, middleware]
 		}),
 		input: (input) => createNewServerActionBuilder({
 			..._def,
@@ -67,11 +60,11 @@ function createServerActionBuilder(initDef = {}) {
 		}),
 		action: (action) => {
 			return async (input) => {
-				const ctx = await _def.middleware?.();
+				let ctx = {};
+				if (_def.middleware.length > 0) ctx = await executeMiddlewares(_def.middleware, ctx);
 				if (_def.input) {
-					const inputSchema = typeof _def.input === "function" ? await _def.input({ ctx }) : _def.input;
-					const result = await standardValidate(inputSchema, input);
-					if (result.issues) throw new __standard_schema_utils.SchemaError(result.issues);
+					const result = await standardValidate(typeof _def.input === "function" ? await _def.input({ ctx }) : _def.input, input);
+					if (result.issues) throw new _standard_schema_utils.SchemaError(result.issues);
 					return await action({
 						ctx,
 						input: result.value
@@ -85,10 +78,10 @@ function createServerActionBuilder(initDef = {}) {
 		},
 		stateAction: (action) => {
 			return async (prevState, rawInput) => {
-				const ctx = await _def.middleware?.();
+				let ctx = {};
+				if (_def.middleware.length > 0) ctx = await executeMiddlewares(_def.middleware, ctx);
 				if (_def.input) {
-					const inputSchema = typeof _def.input === "function" ? await _def.input({ ctx }) : _def.input;
-					const result = await standardValidate(inputSchema, rawInput);
+					const result = await standardValidate(typeof _def.input === "function" ? await _def.input({ ctx }) : _def.input, rawInput);
 					if (result.issues) return await action({
 						ctx,
 						prevState,
@@ -112,10 +105,10 @@ function createServerActionBuilder(initDef = {}) {
 		},
 		formAction: (action) => {
 			return async (prevState, formData) => {
-				const ctx = await _def.middleware?.();
+				let ctx = {};
+				if (_def.middleware.length > 0) ctx = await executeMiddlewares(_def.middleware, ctx);
 				if (_def.input) {
-					const inputSchema = typeof _def.input === "function" ? await _def.input({ ctx }) : _def.input;
-					const result = await standardValidate(inputSchema, formData);
+					const result = await standardValidate(typeof _def.input === "function" ? await _def.input({ ctx }) : _def.input, formData);
 					if (result.issues) return await action({
 						ctx,
 						prevState,

package/dist/{index.d.ts → index.d.cts}

@@ -1,5 +1,10 @@
 import { StandardSchemaV1 } from "@standard-schema/spec";
 
+//#region src/internal/middleware.d.ts
+type MiddlewareFunction<TContext, TReturn> = (params: {
+  ctx: TContext;
+}) => Promise<TReturn> | TReturn;
+//#endregion
 //#region src/internal/schema.d.ts
 declare function getInputErrors(issues: ReadonlyArray<StandardSchemaV1.Issue>): {
   messages: string[];
@@ -15,7 +20,6 @@ type Prettify<T> = { [P in keyof T]: T[P] } & {};
 type SanitizeFunctionParam<T extends (param: any) => any> = T extends ((param: infer P) => infer R) ? Equals<P, undefined> extends true ? () => R : Equals<P, P | undefined> extends true ? (param?: P) => R : (param: P) => R : never;
 type InferParserType<T, TType extends "in" | "out"> = T extends StandardSchemaV1 ? TType extends "in" ? StandardSchemaV1.InferInput<T> : StandardSchemaV1.InferOutput<T> : never;
 type InferInputType<T, TType extends "in" | "out"> = T extends UnsetMarker ? undefined : InferParserType<T, TType>;
-type InferContextType<T> = RemoveUnsetMarker<T>;
 interface ActionParams<TInput = unknown, TContext = unknown> {
   _input: TInput;
   _context: TContext;
@@ -23,16 +27,19 @@ interface ActionParams<TInput = unknown, TContext = unknown> {
 interface ActionBuilder<TParams extends ActionParams> {
   /**
    * Middleware allows you to run code before the action, its return value will pass as context to the action.
+   *
+   * Chaining multiple middlewares is possible, each middleware receives context from previous middlewares
+   * and returns additional context that gets merged.
    */
-  middleware: <TContext>(middleware: () => Promise<TContext> | TContext) => Omit<ActionBuilder<{
+  middleware: <TNewContext>(middleware: MiddlewareFunction<RemoveUnsetMarker<TParams["_context"]>, TNewContext>) => ActionBuilder<{
     _input: TParams["_input"];
-    _context: TContext;
-  }>, "middleware">;
+    _context: TParams["_context"] extends UnsetMarker ? TNewContext : Prettify<TParams["_context"] & TNewContext>;
+  }>;
   /**
    * Input validation for the action.
    */
   input: <TParser extends StandardSchemaV1>(input: ((params: {
-    ctx: InferContextType<TParams["_context"]>;
+    ctx: RemoveUnsetMarker<TParams["_context"]>;
   }) => Promise<TParser> | TParser) | TParser) => Omit<ActionBuilder<{
     _input: TParser;
     _context: TParams["_context"];
@@ -41,14 +48,14 @@ interface ActionBuilder<TParams extends ActionParams> {
    * Create an action.
    */
   action: <TOutput>(action: (params: {
-    ctx: InferContextType<TParams["_context"]>;
+    ctx: RemoveUnsetMarker<TParams["_context"]>;
     input: InferInputType<TParams["_input"], "out">;
   }) => Promise<TOutput>) => SanitizeFunctionParam<(input: InferInputType<TParams["_input"], "in">) => Promise<TOutput>>;
   /**
    * Create an action for React `useActionState`
    */
   stateAction: <TState, TPrevState = UnsetMarker>(action: (params: Prettify<{
-    ctx: InferContextType<TParams["_context"]>;
+    ctx: RemoveUnsetMarker<TParams["_context"]>;
     prevState: RemoveUnsetMarker<TPrevState>;
     rawInput: InferInputType<TParams["_input"], "in">;
   } & ({
@@ -64,7 +71,7 @@ interface ActionBuilder<TParams extends ActionParams> {
    * @deprecated Use `stateAction` instead.
    */
   formAction: <TState, TPrevState = UnsetMarker>(action: (params: Prettify<{
-    ctx: InferContextType<TParams["_context"]>;
+    ctx: RemoveUnsetMarker<TParams["_context"]>;
     prevState: RemoveUnsetMarker<TPrevState>;
     formData: FormData;
   } & ({

package/dist/index.d.mts

@@ -1,5 +1,10 @@
 import { StandardSchemaV1 } from "@standard-schema/spec";
 
+//#region src/internal/middleware.d.ts
+type MiddlewareFunction<TContext, TReturn> = (params: {
+  ctx: TContext;
+}) => Promise<TReturn> | TReturn;
+//#endregion
 //#region src/internal/schema.d.ts
 declare function getInputErrors(issues: ReadonlyArray<StandardSchemaV1.Issue>): {
   messages: string[];
@@ -15,7 +20,6 @@ type Prettify<T> = { [P in keyof T]: T[P] } & {};
 type SanitizeFunctionParam<T extends (param: any) => any> = T extends ((param: infer P) => infer R) ? Equals<P, undefined> extends true ? () => R : Equals<P, P | undefined> extends true ? (param?: P) => R : (param: P) => R : never;
 type InferParserType<T, TType extends "in" | "out"> = T extends StandardSchemaV1 ? TType extends "in" ? StandardSchemaV1.InferInput<T> : StandardSchemaV1.InferOutput<T> : never;
 type InferInputType<T, TType extends "in" | "out"> = T extends UnsetMarker ? undefined : InferParserType<T, TType>;
-type InferContextType<T> = RemoveUnsetMarker<T>;
 interface ActionParams<TInput = unknown, TContext = unknown> {
   _input: TInput;
   _context: TContext;
@@ -23,16 +27,19 @@ interface ActionParams<TInput = unknown, TContext = unknown> {
 interface ActionBuilder<TParams extends ActionParams> {
   /**
    * Middleware allows you to run code before the action, its return value will pass as context to the action.
+   *
+   * Chaining multiple middlewares is possible, each middleware receives context from previous middlewares
+   * and returns additional context that gets merged.
    */
-  middleware: <TContext>(middleware: () => Promise<TContext> | TContext) => Omit<ActionBuilder<{
+  middleware: <TNewContext>(middleware: MiddlewareFunction<RemoveUnsetMarker<TParams["_context"]>, TNewContext>) => ActionBuilder<{
     _input: TParams["_input"];
-    _context: TContext;
-  }>, "middleware">;
+    _context: TParams["_context"] extends UnsetMarker ? TNewContext : Prettify<TParams["_context"] & TNewContext>;
+  }>;
   /**
    * Input validation for the action.
    */
   input: <TParser extends StandardSchemaV1>(input: ((params: {
-    ctx: InferContextType<TParams["_context"]>;
+    ctx: RemoveUnsetMarker<TParams["_context"]>;
   }) => Promise<TParser> | TParser) | TParser) => Omit<ActionBuilder<{
     _input: TParser;
     _context: TParams["_context"];
@@ -41,14 +48,14 @@ interface ActionBuilder<TParams extends ActionParams> {
    * Create an action.
    */
   action: <TOutput>(action: (params: {
-    ctx: InferContextType<TParams["_context"]>;
+    ctx: RemoveUnsetMarker<TParams["_context"]>;
     input: InferInputType<TParams["_input"], "out">;
   }) => Promise<TOutput>) => SanitizeFunctionParam<(input: InferInputType<TParams["_input"], "in">) => Promise<TOutput>>;
   /**
    * Create an action for React `useActionState`
    */
   stateAction: <TState, TPrevState = UnsetMarker>(action: (params: Prettify<{
-    ctx: InferContextType<TParams["_context"]>;
+    ctx: RemoveUnsetMarker<TParams["_context"]>;
     prevState: RemoveUnsetMarker<TPrevState>;
     rawInput: InferInputType<TParams["_input"], "in">;
   } & ({
@@ -64,7 +71,7 @@ interface ActionBuilder<TParams extends ActionParams> {
    * @deprecated Use `stateAction` instead.
    */
   formAction: <TState, TPrevState = UnsetMarker>(action: (params: Prettify<{
-    ctx: InferContextType<TParams["_context"]>;
+    ctx: RemoveUnsetMarker<TParams["_context"]>;
     prevState: RemoveUnsetMarker<TPrevState>;
     formData: FormData;
   } & ({

package/dist/index.mjs

@@ -1,5 +1,22 @@
 import { SchemaError, getDotPath } from "@standard-schema/utils";
 
+//#region src/internal/middleware.ts
+/**
+* Executes an array of middleware functions with the given initial context.
+*/
+async function executeMiddlewares(middlewares, initialCtx) {
+	let ctx = initialCtx && typeof initialCtx === "object" ? { ...initialCtx } : {};
+	for (const middleware of middlewares) {
+		const result = await middleware({ ctx });
+		if (result && typeof result === "object") ctx = {
+			...ctx,
+			...result
+		};
+	}
+	return ctx;
+}
+
+//#endregion
 //#region src/internal/schema.ts
 async function standardValidate(schema, input) {
 	let result = schema["~standard"].validate(input);
@@ -23,20 +40,19 @@ function getInputErrors(issues) {
 
 //#endregion
 //#region src/index.ts
-const unsetMarker = Symbol("unsetMarker");
 function createNewServerActionBuilder(def) {
 	return createServerActionBuilder(def);
 }
 function createServerActionBuilder(initDef = {}) {
 	const _def = {
 		input: void 0,
-		middleware: void 0,
+		middleware: [],
 		...initDef
 	};
 	return {
 		middleware: (middleware) => createNewServerActionBuilder({
 			..._def,
-			middleware
+			middleware: [..._def.middleware, middleware]
 		}),
 		input: (input) => createNewServerActionBuilder({
 			..._def,
@@ -44,10 +60,10 @@ function createServerActionBuilder(initDef = {}) {
 		}),
 		action: (action) => {
 			return async (input) => {
-				const ctx = await _def.middleware?.();
+				let ctx = {};
+				if (_def.middleware.length > 0) ctx = await executeMiddlewares(_def.middleware, ctx);
 				if (_def.input) {
-					const inputSchema = typeof _def.input === "function" ? await _def.input({ ctx }) : _def.input;
-					const result = await standardValidate(inputSchema, input);
+					const result = await standardValidate(typeof _def.input === "function" ? await _def.input({ ctx }) : _def.input, input);
 					if (result.issues) throw new SchemaError(result.issues);
 					return await action({
 						ctx,
@@ -62,10 +78,10 @@ function createServerActionBuilder(initDef = {}) {
 		},
 		stateAction: (action) => {
 			return async (prevState, rawInput) => {
-				const ctx = await _def.middleware?.();
+				let ctx = {};
+				if (_def.middleware.length > 0) ctx = await executeMiddlewares(_def.middleware, ctx);
 				if (_def.input) {
-					const inputSchema = typeof _def.input === "function" ? await _def.input({ ctx }) : _def.input;
-					const result = await standardValidate(inputSchema, rawInput);
+					const result = await standardValidate(typeof _def.input === "function" ? await _def.input({ ctx }) : _def.input, rawInput);
 					if (result.issues) return await action({
 						ctx,
 						prevState,
@@ -89,10 +105,10 @@ function createServerActionBuilder(initDef = {}) {
 		},
 		formAction: (action) => {
 			return async (prevState, formData) => {
-				const ctx = await _def.middleware?.();
+				let ctx = {};
+				if (_def.middleware.length > 0) ctx = await executeMiddlewares(_def.middleware, ctx);
 				if (_def.input) {
-					const inputSchema = typeof _def.input === "function" ? await _def.input({ ctx }) : _def.input;
-					const result = await standardValidate(inputSchema, formData);
+					const result = await standardValidate(typeof _def.input === "function" ? await _def.input({ ctx }) : _def.input, formData);
 					if (result.issues) return await action({
 						ctx,
 						prevState,

package/dist/{utils.js → utils.cjs}

@@ -99,10 +99,7 @@ function set(obj, path, value) {
 */
 function formDataToObject(formData) {
 	const obj = {};
-	for (const [key, value] of formData.entries()) {
-		const parts = key.split(/[\.\[\]]/).filter(Boolean);
-		set(obj, parts, value);
-	}
+	for (const [key, value] of formData.entries()) set(obj, key.split(/[.[\]]/).filter(Boolean), value);
 	return obj;
 }
 

package/dist/utils.mjs

@@ -98,10 +98,7 @@ function set(obj, path, value) {
 */
 function formDataToObject(formData) {
 	const obj = {};
-	for (const [key, value] of formData.entries()) {
-		const parts = key.split(/[\.\[\]]/).filter(Boolean);
-		set(obj, parts, value);
-	}
+	for (const [key, value] of formData.entries()) set(obj, key.split(/[.[\]]/).filter(Boolean), value);
 	return obj;
 }
 

package/package.json

@@ -1,16 +1,33 @@
 {
   "name": "server-act",
-  "version": "1.6.1",
+  "version": "1.7.0",
+  "keywords": [
+    "action",
+    "next",
+    "nextjs",
+    "react",
+    "react server action",
+    "react server component",
+    "rsc",
+    "server action",
+    "server component"
+  ],
   "homepage": "https://github.com/chungweileong94/server-act#readme",
-  "author": "chungweileong94",
+  "bugs": {
+    "url": "https://github.com/chungweileong94/server-act/issues"
+  },
   "license": "MIT",
+  "author": "chungweileong94",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/chungweileong94/server-act.git"
   },
-  "bugs": {
-    "url": "https://github.com/chungweileong94/server-act/issues"
-  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "package.json",
+    "README.md"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -24,23 +41,6 @@
     },
     "./package.json": "./package.json"
   },
-  "files": [
-    "dist",
-    "package.json",
-    "LICENSE",
-    "README.md"
-  ],
-  "keywords": [
-    "next",
-    "nextjs",
-    "react",
-    "react server component",
-    "react server action",
-    "rsc",
-    "server component",
-    "server action",
-    "action"
-  ],
   "dependencies": {
     "@standard-schema/spec": "^1.0.0",
     "@standard-schema/utils": "^0.3.0"