@qualisero/openapi-endpoint 0.16.0 → 0.17.0

package/README.md

@@ -118,10 +118,19 @@ await createPet.mutateAsync({ data: { name: 'Fluffy' } })
 const updatePet = api.updatePet.useMutation({ petId: '123' })
 await updatePet.mutateAsync({ data: { name: 'Updated' } })
 
-// Override path params at call time
+// Deferred path params: omit at hook time, provide at call time
 const deletePet = api.deletePet.useMutation()
 await deletePet.mutateAsync({ pathParams: { petId: '123' } })
 
+// Deferred path params with options
+const updateWithCache = api.updatePet.useMutation(undefined, {
+  invalidateOperations: { listPets: {} },
+})
+await updateWithCache.mutateAsync({
+  data: { name: 'Updated' },
+  pathParams: { petId: '123' },
+})
+
 // With options
 const mutation = api.createPet.useMutation({
   dontInvalidate: true,

package/dist/cli.js

@@ -973,9 +973,15 @@ function _mutationWithParams<Op extends AllOps>(
   type Response = ApiResponse<Op>
   type QueryParams = ApiQueryParams<Op>
 
-  // Two-overload interface: non-function (exact via object-literal checking) +
-  // getter function (exact via NoExcessReturn constraint).
+  // Three-overload interface:
+  // 1. Deferred path params — omit or pass undefined/null; supply at mutateAsync() time via pathParams variable
+  // 2. Eager path params — object, Ref, or ComputedRef (exact via object-literal checking)
+  // 3. Getter function — exact via NoExcessReturn constraint
   type _UseMutation = {
+    (
+      pathParams?: undefined | null,
+      options?: MutationOptions<Response, PathParams, RequestBody, QueryParams>,
+    ): MutationReturn<Response, PathParams, RequestBody, QueryParams>
     (
       pathParams: PathParamsInput | Ref<PathParamsInput> | ComputedRef<PathParamsInput>,
       options?: MutationOptions<Response, PathParams, RequestBody, QueryParams>,
@@ -987,7 +993,7 @@ function _mutationWithParams<Op extends AllOps>(
   }
 
   const _impl = (
-    pathParams: ReactiveOr<PathParamsInput>,
+    pathParams: ReactiveOr<PathParamsInput> | undefined | null,
     options?: MutationOptions<Response, PathParams, RequestBody, QueryParams>,
   ): MutationReturn<Response, PathParams, RequestBody, QueryParams> =>
     useEndpointMutation<Response, PathParams, RequestBody, QueryParams>(
@@ -1009,7 +1015,7 @@ function _mutationWithParams<Op extends AllOps>(
      * - \`isPending\`: Alias for isLoading
      * - \`status\`: 'idle' | 'pending' | 'error' | 'success'
      *
-     * @param pathParams - Path parameters (object, ref, computed, or getter function)
+     * @param pathParams - Path parameters (object, ref, computed, getter function, or undefined/null for deferred supply at call time)
      * @param options - Mutation options (onSuccess, onError, etc.)
      * @returns Mutation result object
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qualisero/openapi-endpoint",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/qualisero/openapi-endpoint.git"