graphql-codegen-flutter-freezed

export declare type ApplyDecoratorOn = 'enum' | 'class' | 'class_factory' | 'union_factory' | 'class_factory_parameter' | 'union_factory_parameter'; export declare type DecoratorToFreezed = { /** * @name arguments * @description arrange the arguments of the directive in order of how the should be outputted * @default null * @exampleMarkdown * ```yml * arguments: [$0] # $0 is the first argument, $1 is the 2nd ... * ``` */ arguments?: string[]; /** * @name applyOn * @description Specify where the decorator should be applied * @exampleMarkdown * ```yml * applyOn: ['class_factory','union_factory'], # applies this decorator on both class and union factory blocks * ``` */ applyOn: ApplyDecoratorOn[]; /** * @name mapsToFreezedAs * @description maps to a Freezed decorator or use `custom` to use a custom decorator */ mapsToFreezedAs: '@Default' | '@deprecated' | 'final' | 'directive' | 'custom'; }; export declare type CustomDecorator = Record<string, DecoratorToFreezed>; export interface FreezedConfig { /** * @name alwaysUseJsonKeyName * @description Use @JsonKey(name: 'name') even if the name is already camelCased * @default false * * @exampleMarkdown * ```yml * generates: * flutter_app/lib/data/models/app_models.dart * plugins: * - flutter-freezed * config: * alwaysUseJsonKeyName: true * * ``` */ alwaysUseJsonKeyName?: boolean; /** * @name copyWith * @description set to false to disable Freezed copyWith method helper * @default undefined * * @exampleMarkdown * ```yml * generates: * flutter_app/lib/data/models/app_models.dart * plugins: * - flutter-freezed * config: * copyWith: false * ``` */ copyWith?: boolean; /** * @name customDecorators * @description maps GraphQL directives to freezed decorators. Arguments of the directive are passed using template strings: $1 is the first argument, $2 is the second... All `mapsToFreezedAs` values except `custom` are parsed so use the name of the directive without the `@` symbol as the key of the customDecorators. With the `custom` value, whatever you use as the key of the custom directive is used just as it is, and the arguments spread into a parenthesis () * @default {} * * @exampleMarkdown * ```yml * generates: * flutter_app/lib/data/models/app_models.dart * plugins: * - flutter-freezed * config: * customDecorators: { * 'default' : { * mapsToFreezedAs: '@Default', * arguments: ['$0'], * }, * 'deprecated' : { * mapsToFreezedAs: '@deprecated', * }, * 'readonly' : { * mapsToFreezedAs: 'final', * }, * '@Assert' : { * mapsToFreezedAs: 'custom', * applyOn: ['class_factory','union_factory'], # @Assert should ONLY be used on factories * arguments: [ * '(email != null && email != "") || (phoneNumber != null && phoneNumber != "")', * 'provide either an email or a phoneNumber', * ], * }, # custom are used just as it given * } * * ``` */ customDecorators?: CustomDecorator; /** * @name defaultUnionConstructor * @description generate empty constructors for Union Types * @default true * * @exampleMarkdown * ```yml * generates: * flutter_app/lib/data/models/app_models.dart * plugins: * - flutter-freezed * config: * defaultUnionConstructor: true * ``` */ defaultUnionConstructor?: boolean; /** * @name equal * @description set to false to disable Freezed equal method helper * @default undefined * * @exampleMarkdown * ```yml * generates: * flutter_app/lib/data/models/app_models.dart * plugins: * - flutter-freezed * config: * equal: false * ``` */ equal?: boolean; /** * @name fromJsonToJson * @description generate fromJson toJson methods on the classes with json_serialization. Requires the [json_serializable](https://pub.dev/packages/json_serializable) to be installed in your Flutter app * @default true * * @exampleMarkdown * ```yml * generates: * flutter_app/lib/data/models/app_models.dart * plugins: * - flutter-freezed * config: * fromJsonToJson: true * * ``` */ fromJsonToJson?: boolean; /** * @name immutable * @description set to true to use the `@freezed` decorator or false to use the `@unfreezed` decorator * @default true * * @exampleMarkdown * ```yml * generates: * flutter_app/lib/data/models/app_models.dart * plugins: * - flutter-freezed * config: * immutable: true * * ``` */ immutable?: boolean; /** * @name makeCollectionsUnmodifiable * @description allows collections(lists/maps) to be modified even if class is immutable * @default undefined * * @exampleMarkdown * ```yml * generates: * flutter_app/lib/data/models/app_models.dart * plugins: * - flutter-freezed * config: * makeCollectionsUnmodifiable: true * * ``` */ makeCollectionsUnmodifiable?: boolean; /** * @name mergeInputs * @description merge InputTypes as a union of an ObjectType where ObjectType is denoted by a $ in the pattern. * @default [] * * @exampleMarkdown * ```yml * generates: * flutter_app/lib/data/models/app_models.dart * plugins: * - flutter-freezed * config: * mergeInputs: ["Create$Input", "Update$Input", "Delete$Input"] * ``` */ mergeInputs?: string[]; /** * @name mutableInputs * @description since inputs will be used to collect data, it makes sense to make them mutable with Freezed's `@unfreezed` decorator. This overrides(in order words: has a higher precedence than) the `immutable` config value `ONLY` for GraphQL `input types`. * @default true * * @exampleMarkdown * ```yml * generates: * flutter_app/lib/data/models/app_models.dart * plugins: * - flutter-freezed * config: * mutableInputs: true * * ``` */ mutableInputs?: boolean; /** * @name privateEmptyConstructor * @description if true, defines a private empty constructor to allow getter and methods to work on the class * @default true * * @exampleMarkdown * ```yml * generates: * flutter_app/lib/data/models/app_models.dart * plugins: * - flutter-freezed * config: * privateEmptyConstructor: true * * ``` */ privateEmptyConstructor?: boolean; /** * @name unionKey * @description specify the key to be used for Freezed union/sealed classes * @default undefined * * @exampleMarkdown * ```yml * generates: * flutter_app/lib/data/models/app_models.dart * plugins: * - flutter-freezed * config: * unionKey: 'type' * * ``` */ unionKey?: string; /** * @name unionValueCase * @description specify the casing style to be used for Freezed union/sealed classes * @default undefined * * @exampleMarkdown * ```yml * generates: * flutter_app/lib/data/models/app_models.dart * plugins: * - flutter-freezed * config: * unionValueCase: 'FreezedUnionCase.pascal' * * ``` */ unionValueCase?: 'FreezedUnionCase.camel' | 'FreezedUnionCase.pascal'; } export interface FieldConfig { /** * @name final * @description marks a field as final * @default undefined */ final?: boolean; /** * @name deprecated * @description marks a field as deprecated * @default undefined */ deprecated?: boolean; /** * @name defaultValue * @description annotate a field with a @Default(value: defaultValue) decorator * @default undefined */ defaultValue?: any; /** * @name customDecorators * @description specific directives to apply to the field. All `mapsToFreezedAs` values except `custom` are parsed so use the name of the directive without the `@` symbol as the key of the customDecorators. With the `custom` value, whatever you use as the key of the custom directive is used just as it is, and the arguments spread into a parenthesis () * @default undefined * @exampleMarkdown * ```yml * customDecorators: { * 'default' : { * mapsToFreezedAs: '@Default', * applyOn: ['class_factory_parameter], * arguments: ['$0'], * }, * 'deprecated' : { * mapsToFreezedAs: '@deprecated', * applyOn: ['union_factory_parameter], * }, * 'readonly' : { * mapsToFreezedAs: 'final', * applyOn: ['class_factory_parameter','union_factory_parameter'], * }, * '@HiveField' : { * mapsToFreezedAs: 'custom', * applyOn: ['class_factory_parameter'], * arguments: ['1'], * }, # custom are used just as it given * } * ``` */ customDecorators?: CustomDecorator; /** * @name constraints * @description TODO: support https://github.com/confuser/graphql-constraint-directive * @exampleMarkdown * ```yml * # THis requires that a validation library is installed in your flutter project * # see: https://github.com/confuser/graphql-constraint-directive * constraint: * minLength: min # same as ['min', '$1'] * maxLength: max * startsWith: ["matches", "/^$1/"] * endsWith: ["matches", "/$1$/"] * contains: ["matches", "/$1/"] * notContains: ["matches", "/^((?!$1).)*$/"] * pattern: ["matches", "/$1/"] * format: * # For example, `@constraint(format: "uri")`. this case $1 will be "uri". * # Therefore the generator generates an @Assert(field.isUri) decorator * # If $1 does not match anywhere, the generator will ignore. * uri: url * email: email * uuid: uuid * ipv4: ipv4 * min: ["min", "$1 - 1"] * max: ["max", "$1 + 1"] * exclusiveMin: min * exclusiveMax: max * ``` * */ constraints?: Record<string, any>; } export interface TypeSpecificFreezedConfig { /** marks a type as deprecated */ deprecated?: boolean; /** overrides the `globalFreezedConfig` for this type */ config?: FreezedConfig; /** configure fields for this type */ fields?: Record<string, FieldConfig>; } export interface FreezedPluginConfig { /** * @name customScalars * @description map custom Scalars to Dart built-in types * @default {} * * @exampleMarkdown * ```yml * generates: * flutter_app/lib/data/models/app_models.dart * plugins: * - flutter-freezed * config: * customScalars: * { * "jsonb": "Map<String, dynamic>", * "timestamptz": "DateTime", * "UUID": "String", * } * ``` */ customScalars?: { [name: string]: string; }; /** * @name fileName * @description if `modular` is set to false, this fileName will be used for the generated output file * @default "app_models" * * @exampleMarkdown * ```yml * generates: * flutter_app/lib/data/models/app_models.dart * plugins: * - flutter-freezed * config: * fileName: app_models * * ``` */ fileName?: string; /** * @name globalFreezedConfig * @description use the same Freezed configuration for every generated output * @default undefined * * @exampleMarkdown * ```yml * generates: * flutter_app/lib/data/models/app_models.dart * plugins: * - flutter-freezed * config: * globalFreezedConfig: * { * immutable: false, * unionValueCase: FreezedUnionCase.pascal, * } * * ``` */ globalFreezedConfig?: FreezedConfig; /** * @name typeSpecificFreezedConfig * @description override the `globalFreezedConfig` for specific types * @default undefined * * @exampleMarkdown * ```yml * generates: * flutter_app/lib/data/models/app_models.dart * plugins: * - flutter-freezed * config: * typeSpecificFreezedConfig: * { * 'Starship':{ * config: { * immutable: false, * unionValueCase: FreezedUnionCase.pascal, * }, * fields: { * 'id': { * final: true, * defaultValue: NanoId.id(), * }, * }, * }, * }, * * ``` */ typeSpecificFreezedConfig?: Record<string, TypeSpecificFreezedConfig>; /** * @name ignoreTypes * @description names of GraphQL types to ignore when generating Freezed classes * @default [] * * @exampleMarkdown * ```yml * generates: * flutter_app/lib/data/models/app_models.dart * plugins: * - flutter-freezed * config: * ignoreTypes: ["PaginatorInfo"] * * ``` */ ignoreTypes?: string[]; /** * @name interfaceNamePrefix * @description append this string to the abstract class name for Interface Types * @default "" * * @exampleMarkdown * ```yml * generates: * flutter_app/lib/data/models/app_models.dart * plugins: * - flutter-freezed * config: * interfaceNamePrefix: "I_" * ``` */ interfaceNamePrefix?: string; /** * @name interfaceNameSuffix * @description prepend this string to the abstract class name for Interface Types * @default "Interface" * * @exampleMarkdown * ```yml * generates: * flutter_app/lib/data/models/app_models.dart * plugins: * - flutter-freezed * config: * interfaceNameSuffix: "Interface" * ``` */ interfaceNameSuffix?: string; /** * @name lowercaseEnums * @description make enum fields lowercase * @default true * * @exampleMarkdown * ```yml * generates: * flutter_app/lib/data/models/app_models.dart * plugins: * - flutter-freezed * config: * lowercaseEnums: true * ``` */ lowercaseEnums?: boolean; /** * @name modular * @description if true, generates each Freezed class in the baseDir * @default true * * @exampleMarkdown * ```yml * generates: * flutter_app/lib/data/models/app_models.dart * plugins: * - flutter-freezed * config: * modular: false * ``` */ modular?: boolean; }