Lifecycle

Master the oRPC lifecycle to confidently implement and customize your procedures.

Overview

Name	Description	Customizable
Handler	Procedures defined with .handler.	✅
Middlewares	Procedures added via .use.	✅
Input Validation	Validates input data against the schema specified in .input.	🟡
Output Validation	Ensures output data conforms to the schema defined in .output.	🟡
Client Interceptors	Interceptors executed before Error Validation.	✅
Error Validation	Flags errors as defined and validate error data if they match the schema in .errors.	🟡
Routing	Determines which procedure to execute based on the incoming request.	✅
Interceptors	Interceptors executed before the Error Handler.	✅
Error Handler	Catches errors and converts them into a response.	🟡
Root Interceptors	Modify the request or response as needed.	✅

Note: The components Routing, Interceptors, Error Handler, and Root Interceptors are not available when using the server-side client.

Middlewares Order

To ensure that all middlewares run after input validation and before output validation apply the following configuration:

const base = os.$config({
  initialInputValidationIndex: Number.NEGATIVE_INFINITY,
  initialOutputValidationIndex: Number.NEGATIVE_INFINITY,
})

INFO

By default, oRPC executes middlewares based on their registration order relative to validation steps. Middlewares registered before .input run before input validation, and those registered after .output run before output validation.