feat!: add createMutationHook for remote mutations (POST/PUT/PATCH/DELETE)

[jtomaszewski]

Summary

• Add createMutationHook wrapping useSWRMutation for POST/PUT/PATCH/DELETE with full OpenAPI type inference
• Rename createMutateHook → createRevalidateHook to clarify its purpose (cache invalidation vs remote mutations)

Usage

const useMutation = createMutationHook(client, "prefix");

// In components:
const { trigger, isMutating } = useMutation("post", "/pet");
await trigger({ body: { name: "Fluffy", photoUrls: [] } });

// Also supports PUT, PATCH, DELETE:
useMutation("put", "/pet");
useMutation("delete", "/pet/{petId}");

Breaking Changes

• createMutateHook renamed to createRevalidateHook
• Requires major version bump

[prescottprue]

Happy to see this - started adding it when this was part of openapi-typescript here: openapi-ts/openapi-typescript#2552 but this seems more fleshed out 👏