Grapher #

Grapher is helper for generate GraphQL from dart code!

Support:

• Type, Input, Enum
• Query, Mutation, Subscription
• Union, Subquery

Not implemented, but plan:

• Fragments generation
• Multiple queries

Usage #

See example project

Annotation have name param, which used for schema validation, if it does not exist validation skipped

Types #

Define class with unnamed or _ constructor, all fields in this constructor used in code generation

Object #

@GrapherObject(name: 'Item')
class Item {
  final ID id;
  final DateTime createdAt;
  final String name;
  final String? description;
  final int count;

  final ItemStatus? status;

  const Item(
    this.id,
    this.createdAt,
    this.name,
    this.description,
    this.count,
    this.status,
  );
}

Input #

@GrapherInput(name: "SelectItemInput")
class SelectItemInput {
  final ID? id;

  const SelectItemInput({this.id});
}

Fields #

All fields maybe annotated for change behavior

@GrapherObject(name: 'Item')
class Item {
  @GrapherField(name: 'code')
  final ID id;

  const Item(
    this.id,
  );
}

Enum #

@GrapherEnum(name: "Status")
enum Status {
    @GrapherEnumValue(name: "new")
    open,
    closed,
}

Actions #

The library uses wrappers that you must use result for further use

Use in

• static function

@GrapherQuery(name: 'items')
static Query<List<Item>> query(SelectItemInput input) => _itemQuery(input);

• top level function

@GrapherQuery(name: 'items')
Query<List<Item>> query(SelectItemInput input) => _itemQuery(input);

• getter if use parent class

@GrapherMutation(name: 'updateItem')
Mutation<Item> get mutation => _updateItemInputMutation(this);

Query #

Mutation #

Subscription #

Options #

Resolvers #

For custom types use resolvers and create custom annotation

Custom resolver maybe const class!

@GrapherResolver(name: 'Timestamp')
class TimestampResolver with GrapherResolverMixin<DateTime> {
  const TimestampResolver();

  @override
  DateTime fromMap(dynamic json) => DateTime.parse(json as String);

  @override
  dynamic toMap(DateTime value) {
    return value.toUtc().toIso8601String();
  }
}

// To avoid import issues, define the resolver class or instance in the same file as the new annotations.
const timestampResolver = TimestampResolver();

// Example for GrapherObject
class ProjectObject extends GrapherObject {
  const ProjectObject({super.name})
    : super(resolvers: const [timestampResolver]);
}

// And use @ProjectObject(name:)