@orpc/react 0.0.0-next.f16d90e → 0.0.0-next.f356b86

package/README.md

@@ -30,7 +30,7 @@
 - **🔗 End-to-End Type Safety**: Ensure type-safe inputs, outputs, and errors from client to server.
 - **📘 First-Class OpenAPI**: Built-in support that fully adheres to the OpenAPI standard.
 - **📝 Contract-First Development**: Optionally define your API contract before implementation.
-- **⚙️ Framework Integrations**: Seamlessly integrate with TanStack Query (React, Vue, Solid, Svelte), Pinia Colada, and more.
+- **⚙️ Framework Integrations**: Seamlessly integrate with TanStack Query (React, Vue, Solid, Svelte, Angular), Pinia Colada, and more.
 - **🚀 Server Actions**: Fully compatible with React Server Actions on Next.js, TanStack Start, and other platforms.
 - **🔠 Standard Schema Support**: Works out of the box with Zod, Valibot, ArkType, and other schema validators.
 - **🗃️ Native Types**: Supports native types like Date, File, Blob, BigInt, URL, and more.
@@ -49,14 +49,12 @@ You can find the full documentation [here](https://orpc.unnoq.com).
 - [@orpc/contract](https://www.npmjs.com/package/@orpc/contract): Build your API contract.
 - [@orpc/server](https://www.npmjs.com/package/@orpc/server): Build your API or implement API contract.
 - [@orpc/client](https://www.npmjs.com/package/@orpc/client): Consume your API on the client with type-safety.
-- [@orpc/nest](https://www.npmjs.com/package/@orpc/nest): Deeply integrate oRPC with NestJS.
+- [@orpc/openapi](https://www.npmjs.com/package/@orpc/openapi): Generate OpenAPI specs and handle OpenAPI requests.
+- [@orpc/nest](https://www.npmjs.com/package/@orpc/nest): Deeply integrate oRPC with [NestJS](https://nestjs.com/).
 - [@orpc/react](https://www.npmjs.com/package/@orpc/react): Utilities for integrating oRPC with React and React Server Actions.
-- [@orpc/react-query](https://www.npmjs.com/package/@orpc/react-query): Integration with [React Query](https://tanstack.com/query/latest/docs/framework/react/overview).
-- [@orpc/vue-query](https://www.npmjs.com/package/@orpc/vue-query): Integration with [Vue Query](https://tanstack.com/query/latest/docs/framework/vue/overview).
-- [@orpc/solid-query](https://www.npmjs.com/package/@orpc/solid-query): Integration with [Solid Query](https://tanstack.com/query/latest/docs/framework/solid/overview).
-- [@orpc/svelte-query](https://www.npmjs.com/package/@orpc/svelte-query): Integration with [Svelte Query](https://tanstack.com/query/latest/docs/framework/svelte/overview).
+- [@orpc/tanstack-query](https://www.npmjs.com/package/@orpc/tanstack-query): [TanStack Query](https://tanstack.com/query/latest) integration.
 - [@orpc/vue-colada](https://www.npmjs.com/package/@orpc/vue-colada): Integration with [Pinia Colada](https://pinia-colada.esm.dev/).
-- [@orpc/openapi](https://www.npmjs.com/package/@orpc/openapi): Generate OpenAPI specs and handle OpenAPI requests.
+- [@orpc/hey-api](https://www.npmjs.com/package/@orpc/hey-api): [Hey API](https://heyapi.dev/) integration.
 - [@orpc/zod](https://www.npmjs.com/package/@orpc/zod): More schemas that [Zod](https://zod.dev/) doesn't support yet.
 - [@orpc/valibot](https://www.npmjs.com/package/@orpc/valibot): OpenAPI spec generation from [Valibot](https://valibot.dev/).
 - [@orpc/arktype](https://www.npmjs.com/package/@orpc/arktype): OpenAPI spec generation from [ArkType](https://arktype.io/).

package/dist/hooks/index.d.mts

@@ -58,12 +58,22 @@ interface UseServerActionErrorResult<TInput, TOutput, TError> extends UseServerA
     status: 'error';
     executedAt: Date;
 }
+type UseServerActionResult<TInput, TOutput, TError> = UseServerActionIdleResult<TInput, TOutput, TError> | UseServerActionSuccessResult<TInput, TOutput, TError> | UseServerActionErrorResult<TInput, TOutput, TError> | UseServerActionPendingResult<TInput, TOutput, TError>;
 /**
  * Use a Server Action Hook
  *
  * @see {@link https://orpc.unnoq.com/docs/server-action#useserveraction-hook Server Action Hook Docs}
  */
-declare function useServerAction<TInput, TOutput, TError extends ORPCErrorJSON<any, any>>(action: ActionableClient<TInput, TOutput, TError>, options?: NoInfer<UseServerActionOptions<TInput, TOutput, UnactionableError<TError>>>): UseServerActionIdleResult<TInput, TOutput, UnactionableError<TError>> | UseServerActionSuccessResult<TInput, TOutput, UnactionableError<TError>> | UseServerActionErrorResult<TInput, TOutput, UnactionableError<TError>> | UseServerActionPendingResult<TInput, TOutput, UnactionableError<TError>>;
+declare function useServerAction<TInput, TOutput, TError extends ORPCErrorJSON<any, any>>(action: ActionableClient<TInput, TOutput, TError>, options?: UseServerActionOptions<TInput, TOutput, UnactionableError<TError>>): UseServerActionResult<TInput, TOutput, UnactionableError<TError>>;
 
-export { useServerAction };
-export type { UseServerActionErrorResult, UseServerActionExecuteOptions, UseServerActionExecuteRest, UseServerActionIdleResult, UseServerActionOptions, UseServerActionPendingResult, UseServerActionResultBase, UseServerActionSuccessResult };
+interface UseOptimisticServerActionOptions<TInput, TOutput, TError, TOptimisticState> extends UseServerActionOptions<TInput, TOutput, TError> {
+    optimisticPassthrough: TOptimisticState;
+    optimisticReducer: (state: TOptimisticState, input: TInput) => TOptimisticState;
+}
+type UseOptimisticServerActionResult<TInput, TOutput, TError, TOptimisticState> = UseServerActionResult<TInput, TOutput, TError> & {
+    optimisticState: TOptimisticState;
+};
+declare function useOptimisticServerAction<TInput, TOutput, TError extends ORPCErrorJSON<any, any>, TOptimisticState>(action: ActionableClient<TInput, TOutput, TError>, options: UseOptimisticServerActionOptions<TInput, TOutput, UnactionableError<TError>, TOptimisticState>): UseOptimisticServerActionResult<TInput, TOutput, UnactionableError<TError>, TOptimisticState>;
+
+export { useOptimisticServerAction, useServerAction };
+export type { UseOptimisticServerActionOptions, UseOptimisticServerActionResult, UseServerActionErrorResult, UseServerActionExecuteOptions, UseServerActionExecuteRest, UseServerActionIdleResult, UseServerActionOptions, UseServerActionPendingResult, UseServerActionResult, UseServerActionResultBase, UseServerActionSuccessResult };

package/dist/hooks/index.d.ts

@@ -58,12 +58,22 @@ interface UseServerActionErrorResult<TInput, TOutput, TError> extends UseServerA
     status: 'error';
     executedAt: Date;
 }
+type UseServerActionResult<TInput, TOutput, TError> = UseServerActionIdleResult<TInput, TOutput, TError> | UseServerActionSuccessResult<TInput, TOutput, TError> | UseServerActionErrorResult<TInput, TOutput, TError> | UseServerActionPendingResult<TInput, TOutput, TError>;
 /**
  * Use a Server Action Hook
  *
  * @see {@link https://orpc.unnoq.com/docs/server-action#useserveraction-hook Server Action Hook Docs}
  */
-declare function useServerAction<TInput, TOutput, TError extends ORPCErrorJSON<any, any>>(action: ActionableClient<TInput, TOutput, TError>, options?: NoInfer<UseServerActionOptions<TInput, TOutput, UnactionableError<TError>>>): UseServerActionIdleResult<TInput, TOutput, UnactionableError<TError>> | UseServerActionSuccessResult<TInput, TOutput, UnactionableError<TError>> | UseServerActionErrorResult<TInput, TOutput, UnactionableError<TError>> | UseServerActionPendingResult<TInput, TOutput, UnactionableError<TError>>;
+declare function useServerAction<TInput, TOutput, TError extends ORPCErrorJSON<any, any>>(action: ActionableClient<TInput, TOutput, TError>, options?: UseServerActionOptions<TInput, TOutput, UnactionableError<TError>>): UseServerActionResult<TInput, TOutput, UnactionableError<TError>>;
 
-export { useServerAction };
-export type { UseServerActionErrorResult, UseServerActionExecuteOptions, UseServerActionExecuteRest, UseServerActionIdleResult, UseServerActionOptions, UseServerActionPendingResult, UseServerActionResultBase, UseServerActionSuccessResult };
+interface UseOptimisticServerActionOptions<TInput, TOutput, TError, TOptimisticState> extends UseServerActionOptions<TInput, TOutput, TError> {
+    optimisticPassthrough: TOptimisticState;
+    optimisticReducer: (state: TOptimisticState, input: TInput) => TOptimisticState;
+}
+type UseOptimisticServerActionResult<TInput, TOutput, TError, TOptimisticState> = UseServerActionResult<TInput, TOutput, TError> & {
+    optimisticState: TOptimisticState;
+};
+declare function useOptimisticServerAction<TInput, TOutput, TError extends ORPCErrorJSON<any, any>, TOptimisticState>(action: ActionableClient<TInput, TOutput, TError>, options: UseOptimisticServerActionOptions<TInput, TOutput, UnactionableError<TError>, TOptimisticState>): UseOptimisticServerActionResult<TInput, TOutput, UnactionableError<TError>, TOptimisticState>;
+
+export { useOptimisticServerAction, useServerAction };
+export type { UseOptimisticServerActionOptions, UseOptimisticServerActionResult, UseServerActionErrorResult, UseServerActionExecuteOptions, UseServerActionExecuteRest, UseServerActionIdleResult, UseServerActionOptions, UseServerActionPendingResult, UseServerActionResult, UseServerActionResultBase, UseServerActionSuccessResult };

package/dist/hooks/index.mjs

@@ -1,6 +1,6 @@
+import { intercept, toArray, onStart } from '@orpc/shared';
+import { useState, useRef, useTransition, useCallback, useMemo, useOptimistic } from 'react';
 import { safe, createORPCErrorFromJson } from '@orpc/client';
-import { intercept, toArray } from '@orpc/shared';
-import { useState, useRef, useTransition, useCallback, useMemo } from 'react';
 
 const INITIAL_STATE = {
   data: void 0,
@@ -74,4 +74,18 @@ function useServerAction(action, options = {}) {
   return result;
 }
 
-export { useServerAction };
+function useOptimisticServerAction(action, options) {
+  const [optimisticState, addOptimistic] = useOptimistic(options.optimisticPassthrough, options.optimisticReducer);
+  const state = useServerAction(action, {
+    ...options,
+    interceptors: [
+      useCallback(onStart(({ input }) => {
+        addOptimistic(input);
+      }), [addOptimistic]),
+      ...toArray(options.interceptors)
+    ]
+  });
+  return useMemo(() => ({ ...state, optimisticState }), [state, optimisticState]);
+}
+
+export { useOptimisticServerAction, useServerAction };

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { AnySchema } from '@orpc/contract';
 import { Context, ErrorMap, Meta, Lazyable, Procedure, CreateProcedureClientOptions } from '@orpc/server';
-import { Interceptor, MaybeOptionalOptions } from '@orpc/shared';
+import { Interceptor, MaybeOptionalOptions, onStart, onSuccess, onError, onFinish } from '@orpc/shared';
 export { getIssueMessage, parseFormData } from '@orpc/openapi-client/standard';
 
 interface FormAction {
@@ -15,5 +15,22 @@ declare const orpcErrorToNextHttpFallbackInterceptor: Interceptor<any, Promise<a
  */
 declare function createFormAction<TInitialContext extends Context, TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap, TMeta extends Meta>(lazyableProcedure: Lazyable<Procedure<TInitialContext, any, TInputSchema, TOutputSchema, TErrorMap, TMeta>>, ...rest: MaybeOptionalOptions<CreateProcedureClientOptions<TInitialContext, TOutputSchema, TErrorMap, TMeta, Record<never, never>>>): FormAction;
 
-export { createFormAction, orpcErrorToNextHttpFallbackInterceptor };
+/**
+ * Like `onStart`, but defers execution, useful for updating states.
+ */
+declare const onStartDeferred: typeof onStart;
+/**
+ * Like `onSuccess`, but defers execution, useful for updating states.
+ */
+declare const onSuccessDeferred: typeof onSuccess;
+/**
+ * Like `onError`, but defers execution, useful for updating states.
+ */
+declare const onErrorDeferred: typeof onError;
+/**
+ * Like `onFinish`, but defers execution, useful for updating states.
+ */
+declare const onFinishDeferred: typeof onFinish;
+
+export { createFormAction, onErrorDeferred, onFinishDeferred, onStartDeferred, onSuccessDeferred, orpcErrorToNextHttpFallbackInterceptor };
 export type { FormAction };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { AnySchema } from '@orpc/contract';
 import { Context, ErrorMap, Meta, Lazyable, Procedure, CreateProcedureClientOptions } from '@orpc/server';
-import { Interceptor, MaybeOptionalOptions } from '@orpc/shared';
+import { Interceptor, MaybeOptionalOptions, onStart, onSuccess, onError, onFinish } from '@orpc/shared';
 export { getIssueMessage, parseFormData } from '@orpc/openapi-client/standard';
 
 interface FormAction {
@@ -15,5 +15,22 @@ declare const orpcErrorToNextHttpFallbackInterceptor: Interceptor<any, Promise<a
  */
 declare function createFormAction<TInitialContext extends Context, TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap, TMeta extends Meta>(lazyableProcedure: Lazyable<Procedure<TInitialContext, any, TInputSchema, TOutputSchema, TErrorMap, TMeta>>, ...rest: MaybeOptionalOptions<CreateProcedureClientOptions<TInitialContext, TOutputSchema, TErrorMap, TMeta, Record<never, never>>>): FormAction;
 
-export { createFormAction, orpcErrorToNextHttpFallbackInterceptor };
+/**
+ * Like `onStart`, but defers execution, useful for updating states.
+ */
+declare const onStartDeferred: typeof onStart;
+/**
+ * Like `onSuccess`, but defers execution, useful for updating states.
+ */
+declare const onSuccessDeferred: typeof onSuccess;
+/**
+ * Like `onError`, but defers execution, useful for updating states.
+ */
+declare const onErrorDeferred: typeof onError;
+/**
+ * Like `onFinish`, but defers execution, useful for updating states.
+ */
+declare const onFinishDeferred: typeof onFinish;
+
+export { createFormAction, onErrorDeferred, onFinishDeferred, onStartDeferred, onSuccessDeferred, orpcErrorToNextHttpFallbackInterceptor };
 export type { FormAction };

package/dist/index.mjs

@@ -2,7 +2,7 @@ import { ORPCError, createORPCErrorFromJson } from '@orpc/client';
 import { StandardBracketNotationSerializer } from '@orpc/openapi-client/standard';
 export { getIssueMessage, parseFormData } from '@orpc/openapi-client/standard';
 import { createProcedureClient } from '@orpc/server';
-import { onError, resolveMaybeOptionalOptions, toArray } from '@orpc/shared';
+import { onError, resolveMaybeOptionalOptions, toArray, onStart, onSuccess, onFinish } from '@orpc/shared';
 
 const orpcErrorToNextHttpFallbackInterceptor = onError((error) => {
   if (error instanceof ORPCError && [401, 403, 404].includes(error.status)) {
@@ -25,4 +25,33 @@ function createFormAction(lazyableProcedure, ...rest) {
   };
 }
 
-export { createFormAction, orpcErrorToNextHttpFallbackInterceptor };
+const onStartDeferred = (callback, ...rest) => {
+  return onStart((...args) => {
+    setTimeout(() => {
+      callback(...args);
+    }, 6);
+  }, ...rest);
+};
+const onSuccessDeferred = (callback, ...rest) => {
+  return onSuccess((...args) => {
+    setTimeout(() => {
+      callback(...args);
+    }, 6);
+  }, ...rest);
+};
+const onErrorDeferred = (callback, ...rest) => {
+  return onError((...args) => {
+    setTimeout(() => {
+      callback(...args);
+    }, 6);
+  }, ...rest);
+};
+const onFinishDeferred = (callback, ...rest) => {
+  return onFinish((...args) => {
+    setTimeout(() => {
+      callback(...args);
+    }, 6);
+  }, ...rest);
+};
+
+export { createFormAction, onErrorDeferred, onFinishDeferred, onStartDeferred, onSuccessDeferred, orpcErrorToNextHttpFallbackInterceptor };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@orpc/react",
   "type": "module",
-  "version": "0.0.0-next.f16d90e",
+  "version": "0.0.0-next.f356b86",
   "license": "MIT",
   "homepage": "https://orpc.unnoq.com",
   "repository": {
@@ -34,15 +34,15 @@
     "react": ">=18.0.0"
   },
   "dependencies": {
-    "@orpc/contract": "0.0.0-next.f16d90e",
-    "@orpc/openapi-client": "0.0.0-next.f16d90e",
-    "@orpc/server": "0.0.0-next.f16d90e",
-    "@orpc/shared": "0.0.0-next.f16d90e",
-    "@orpc/client": "0.0.0-next.f16d90e"
+    "@orpc/client": "0.0.0-next.f356b86",
+    "@orpc/openapi-client": "0.0.0-next.f356b86",
+    "@orpc/shared": "0.0.0-next.f356b86",
+    "@orpc/server": "0.0.0-next.f356b86",
+    "@orpc/contract": "0.0.0-next.f356b86"
   },
   "devDependencies": {
     "react": "^19.1.0",
-    "zod": "^3.25.11"
+    "zod": "^3.25.76"
   },
   "scripts": {
     "build": "unbuild",