Add @upsert directive and nested mutation operations to create or update a model regardless whether it exists

[joskfg]

• Added or updated tests
• Added Docs for all relevant versions
• Updated the changelog

Resolves #995

Changes

Upsert

Use the @upsert directive to update a model with
a given id or create it if it does not exist.

type Mutation {
  upsertUser(id: ID!, name: String!, email: String): User @upsert
}

Since upsert can create or update your data you must have all the minimum fields for a creation as required.
The id is always required and must be marked as fillable in the model.

mutation {
  upsertUser(id: "123" name: "Hillary"){
    id
    name
    email
  }
}

{
  "data": {
    "upsertUser": {
      "id": "123",
      "name": "Hillary",
      "email": null
    }
  }
}

Nested mutations

You can now expose a nested operation upsert in all nested mutations that support the update operation.

Breaking changes

-

[spawnia]

I am really impressed with how quickly you were able to dig into this and added a solid implementation with comprehensive tests, while sticking to the existing codestyle.

Apart from the doc entry in the directives reference, there is also https://lighthouse-php.com/master/eloquent/getting-started.html#update and https://lighthouse-php.com/master/eloquent/nested-mutations.html

[joskfg]

Lets reframe this so we won't have to keep updating the number

I am really impressed with how quickly you were able to dig into this and added a solid implementation with comprehensive tests, while sticking to the existing codestyle.

Apart from the doc entry in the directives reference, there is also https://lighthouse-php.com/master/eloquent/getting-started.html#update and https://lighthouse-php.com/master/eloquent/nested-mutations.html

Thanks! Added missing documentation.

[joskfg]

I prefer this indentation

[spawnia]

Massive effort and great job on this cool new feature, @joskfg

Thank you!