feat: add query key function

[seriouslag]

This PR is to make it easier for consumers to invalidate queries.

This is achieved by exporting a new function that builds the query keys.
This function is used internally to build the queryKey for the hooks.

The new functions are the name of the queryHook + 'Key' + 'Fn' and the first letter is capitalized.

We capitalize the first letter because the lowercase 'use' is reserved for hooks and all our queryHook start with use.

// example
import {
  usePetServiceFindPetsByStatus,
  usePetServiceAddPet,
  UsePetServiceFindPetsByStatusKeyFn,
} from "../openapi/queries";
import React from 'react';

// App.tsx
function App() {
  const [status, setStatus] = React.useState('available');
  const { data } = usePetServiceFindPetsByStatus({ status });
  const { mutate } = usePetServiceAddPet({
    onSuccess: () => {
      queryClient.invalidateQueries({
        // Call the query key function to get the query key
        // this is important to ensure the query key is created the same way as the query hook,
        // this insures the cache is invalidated correctly.
        queryKey: [UsePetServiceFindPetsByStatusKeyFn({
          status,
        })],
      });
    },
  });

  return (
    <div className="App">
      <h1>Pet List</h1>
      <ul>{data?.map((pet) => <li key={pet.id}>{pet.name}</li>)}</ul>
      <button
        onClick={() => {
          mutate({ name: "Fluffy", status: "available" });
        }}
      >
        Add Pet
      </button>
    </div>
  );
}

export default App;

[github-actions]

Coverage Report

Status	Category	Percentage	Covered / Total
🟢	Lines	99.07% (🎯 95%)	1821 / 1838
🟢	Statements	99.07% (🎯 95%)	1821 / 1838
🟢	Functions	100% (🎯 95%)	40 / 40
🟢	Branches	94.51% (🎯 85%)	155 / 164

File Coverage

File	Stmts	% Branch	% Funcs	% Lines	Uncovered Lines
Changed Files
src/common.mts	100%	100%	100%	100%
src/createExports.mts	100%	100%	100%	100%
src/createUseQuery.mts	99.81%	97.43%	100%	99.81%	543

Generated in workflow #248

[seriouslag]

npm publish

[7nohe]

good work

[seriouslag]

@7nohe merged, mind releasing a new version?