Signature

interface ClientActionFunctionArgs extends LoaderFunctionArgs {
  serverAction: <T = unknown>() => Promise<T>;
}

Contract

Extends LoaderFunctionArgs with serverAction<T>(): Promise<T>. The installed application transport forwards the request to the registered server action when this callback is invoked.

import type { ClientActionFunctionArgs } from "@kasperrt/smolter/preact";

interface SavedTask {
  id: string;
}

export async function clientAction({ serverAction }: ClientActionFunctionArgs) {
  const task = await serverAction<SavedTask>();

  return { ...task, saved: true };
}

Usage and limits

Keep mutations in actions rather than components. Calling serverAction is optional; a client-only action may perform client-side work instead. The callback requires transport wiring and the generic is a type assertion, not runtime response validation.

Fields

serverAction: <T = unknown>() => Promise<T>;