MichalLytek / MichalLytek/type-graphql

Allow defaulting logic to logic to occur when a property is null or undefined.

Open
#1,782 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Community :family_man_girl: Discussion :speech_balloon: Need More Info :man_shrugging:
Dominant language
TypeScript
Stars
8.1k
Forks
672
PR merge metrics
No merged PRs in 30d

Description

**Is your feature request related to a problem? Please describe.**

When declaring optional properties on an input object, it would be nice if the `@Arg` decorator respected the default vaults provided in the `@InputType`.

I have an example reproduction here: https://github.com/dwjohnston/type-graphql/tree/master/examples/defaulting

Say I have an object representing a list of filters.
All of the filters are optional from the consumers point of view, but if not provided, some kind of default will be used.

```
@InputType()
export class RecipeFilterInput {
@Field(() => [RecipeTags], {
// The property is nullable
nullable: true,
defaultValue: [RecipeTags.Vegan],
})
// But is typed to always exist, because the default value will be provided.
allowedTags!: RecipeTags[];
}
```

When we go to use this as an arg:

We also want the filters object itself to be nullable. If the user does not provide the object, then we would want one of the filter objects will all the default values to be used.

There's a few ways this can be done, I'll list them here.

## Approach 1 - nullable, no default value provided. ❌

```
async recipes(
@Arg("filters", {
nullable: true,
})
filters: RecipeFilterInput,
): Promise {
console.log(filters);
```

This will error when executing:

```
query ExampleQuery {

recipe {
title
}
}

```

With:

```
"message": "Cannot read properties of undefined (reading 'allowedTags')",
```

(filters logs `undefined`).

This also errors when executing

```
query ExampleQuery($filters: RecipeFilterInput) {

recipes(filters: $filters) {
title
}
}

input: {
"filters": null
}

```

```
"message": "Cannot read properties of null (reading 'allowedTags')",
```

## Approach 2 - nullable, with an empty object default value provided. ❌

```
async recipes(
@Arg("filters", {
nullable: true,

defaultValue: {},
})
filters: RecipeFilterInput,
): Promise {
console.log(filters);
```

This doesn't error, but it doesn't have the desired behaviour when we execute this query:

```
query ExampleQuery {

recipe {
title
}
}

```

(filters logs `RecipeFilterInput {}`).

## Approach 3 - nullable, with full defaulting provided: ✅ ❌

```
async recipes(
@Arg("filters", {
nullable: true,
defaultValue: {
allowedTags: [RecipeTags.Vegan],
},
})
filters: RecipeFilterInput,
): Promise {
console.log(filters);
```

This works, for a query like this:

```
query ExampleQuery {

recipe {
title
}
}

```

But not for a query like

```
query ExampleQuery($filters: RecipeFilterInput) {

recipes(filters: $filters) {
title
}
}

input: {
"filters": null
}

```

This approach is also not ideal, as it has us repeating the defaulting logic in two places.

**Describe the solution you'd like**

What should happen in this scenario is two parts.

1. The framework asserts for the existence of the arg object. If it does not exist, provide the default value. (Empty object in approach 2, Full object in approach 3).

2. Then, the framework inspects the properties of the object, if they do not exist, it provides the default value as defined in the `@Field` annotation.

**Describe alternatives you've considered**

A partial alternative is that we don't provide a single object for the filter, and instead we provide the filters individually:

```
async recipes(
@Arg("allowedTags", () => [RecipeTags], {
nullable: true,
defaultValue: [RecipeTags.Vegan],
})
allowedTags: RecipeTags[],
): Promise {
console.log(allowedTags);
```

This solves the redundancy of providing the default values in two places. But It will still have non-defaulting behaviour if the user does provide a null argument.

Alternative solution is to abandon any defaulting logic via type-grapqhl and just do something like:

```
async recipes(
@Arg("filters", {
nullable: true,
})
filters: RecipeFilterInput | null,
): Promise {
console.log(filters);
const filterSet = new Set(filters?.allowedTags ?? [RecipeTags.Vegan]);
```

**Additional context**

Related issue:

https://github.com/MichalLytek/type-graphql/issues/697

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the reproduction in examples/defaulting and review the related issue #697. Verify the desired behavior for omitted and null nullable arguments, including applying defaults declared on nested @Field properties; done when both cases produce the expected defaulted input without duplicated defaults.

Written by the indexing model from the issue text.

Assessment

Tech stack
graphql, typescript
Domain
api, backend
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.