Skip to content
This repository was archived by the owner on Nov 12, 2024. It is now read-only.

CHANGELOG-ELM-PACKAGE.md

Latest commit

 

History

History
441 lines (292 loc) · 16.3 KB

CHANGELOG-ELM-PACKAGE.md

File metadata and controls

441 lines (292 loc) · 16.3 KB

Changelog Elm package

All notable changes to the dillonkearns/elm-graphql elm package will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

[Unreleased]

[5.0.0] - 2019-12-16

Changed

  • (MAJOR API change) Fix order of arguments for Http pipeline function, withOperationName (fixes #254).
  • (MAJOR API change) Switch discardParsedErrorData from returning a () to an unconstrained a. This makes it a little more flexible for users in terms of the types it allows, without changing the behavior. See #245 (thank you @Jayshua!).
  • (MAJOR API change) fix typo in internal function name (exhuastiveFragmentSelection -> exhaustiveFragmentSelection).

[4.5.0] - 2019-12-03

Fixed

  • Expose Graphql.Http.withOperationName function (which was mistakenly left out last release).

[4.4.0] - 2019-10-14

Added

  • Graphql.Http.withOperationName allows you to (optionally) add operation names to your GraphQL queries (thank you @asterite for your PR! dillonkearns#195)

[4.3.1] - 2019-06-30

Fixed

  • Parse pre-execution GraphQL response that has "error" but no "data" (see #168).

[4.3.0] - 2019-06-13

Added

  • Added SeletionSet.foldl
  • Added OptionalArgument.fromMaybeWithNull

[4.2.1] - 2019-04-17

Changed

  • Don't use field aliases for __typename fields (see PR #121).

[4.2.0] - 2019-01-25

Added

  • SelectionSet.list lets you combine a List of SelectionSet value typeLocks into a single SelectionSet (List value) typeLock.
  • SelectionSet.dict lets you combine a List of (String, SelectionSet value typeLock)s into a single SelectionSet (Dict String value) typeLock. The Strings in the list are used as the key in the Dict.
  • Expose type Graphql.Codec (for use with the --scalar-codecs CLI flag, see this example).

[4.1.0] - 2018-12-16

Added

  • Expose type Graphql.Http.HttpError

[4.0.0] - 2018-12-15

Changed

module Graphql.Http.Error exposing -- ..
type alias Error parsedData =
    RawError parsedData HttpError

type RawError parsedData httpError
    = GraphqlError (GraphqlError.PossiblyParsedData parsedData) (List GraphqlError.GraphqlError)
    | HttpError httpError


type HttpError
    = BadUrl String
    | Timeout
    | NetworkError
    | BadStatus Http.Metadata String
    | BadPayload Json.Decode.Error

See the full details here: dillonkearns#89 Note that this will only require you to change your code if you were destructuring the Graphql.Http.HttpError values. And the changes introduce a function to map into the old type easily:

withSimpleHttpError : Result (Error parsedData) decodesTo -> Result (RawError parsedData Http.Error) decodesTo

Well, not exactly the old type, the old type was Graphql.Http.Error parsedData, the new type is written out as Graphql.Http.RawError parsedData Http.Error, but it would contains the same data as before.

Removed

  • Graphql.Http.fromHttpError was removed as it no longer makes sense with the default type wrapping Graphql.Http.HttpError instead of Http.Error. See the Graphql.Http.withSimpleHttpError docs if you are looking to combine a Graphql response with an Http response.
  • Removed ignoreParsedErrorData to avoid confusion. It's easier to use discardParsedErrorData, use that function instead. It maps the entire result so you don't have to use it in combination with Graphql.Http.mapError.

[3.0.0] - 2018-12-08

Changed

  • Only the internal code changed in this release, so you won't need to do anything to upgrade your own code besides re-running the latest CLI tool. The change includes the type information of a field in its field alias hash. Since the alias is now unique to each field's type and argument values, you can no longer encounter validation errors when you build up a query using unions or interfaces that include fields with the same names but different types. See dillonkearns#95 for more details.

[2.0.0] - 2018-12-02

Changed

  • The Field module has been removed. With this change, think of a Field as just a special case of a SelectionSet. The SelectionSet is now used for both a single element or multiple (much like a single Cmd msg or multiple with Cmd.batch [cmd1, cmd2]). This means that any functions you called on Field before are now in SelectionSet (so it's SelectionSet.nonNullOrFail, SelectionSet.map, etc). The latest docs page for SelectionSet now has a nice tutorial in it that walks you through the new way that SelectionSets work. If you're trying to wrap your head around the new design, I highly recommend you read this page!

    To migrate to the new version, just follow these steps:

    • Find and delete all calls to import Graphql.Field in your code entirely
    • Anywhere you called SelectionSet.fieldSelection can simply be removed now.
    • Anywhere you called Field.map, mapOrFail, etc., is just SelectionSet.map, etc. now.
    • Remove any calls to <GeneratedModule>.selection and replace it with SelectionSet.succeed (for Union types, the selection function has been renamed to fragments, see the last point below).
    • Any annotations which were Field decodesTo typeLock, simply change them to SelectionSet decodesTo typeLock

  • The .selection function for Unions has been renamed to .fragments to be consistent with the naming for Interfaces.

Added

  • Add SelectionSet.mapN functions for an alternate syntax to the pipeline syntax (starting a pipeline with SelectionSet.succeed).
  • New SeletionSet.withDefault. Just a convenience function which is equivalent to SelectionSet.map Maybe.withDefault.

[1.5.1] - 2018-12-01

Fixed

  • The withCredentials was inverted with release 1.4.0. So it would use the Http.risky and Http.riskyTask versions if you didn't call withCredentials , and it would use the regular Http.request and Http.task builders if you did. Thank you @kyasu1 for reporting the problem! See #97.

[1.5.0] - 2018-11-27

Added

  • Add new internal builder function, for use with the new generated code for building exhaustive Union and Interface fragments. See this diff to understand the changes and how to migrate: e530d94.

[1.4.0] - 2018-11-15

Changed

  • Bump underlying elm/http and elm/json packages.

Added

[1.3.0] - 2018-11-14

Added

  • Add discardParsedErrorData to make it easier to map errors into a type that can be easily merged together (something that looks like Result (Error ()) decodesTo).
  • Add parseableErrorAsSuccess, which treats any GraphQL errors like successful responses (throws away the GraphQL error) as long as it is able to successfully run the decoder (it won't be able to if the data returned is partial).

[1.2.0] - 2018-11-06

Added

Changed

  • The generated selection sets now will include at least a __typename to ensure they are valid (empty selection sets are invalid in GraphQL). Previously you could get an invalid GraphQL query if you used SelectionSet.hardcoded.
  • (Internal implementation details, not public facing though the generated queries will look slightly different now) - The alias generation has changed to be independent of surrounding context. The new algorithm will generate an alias for any field if and only if that field has arguments. You can read more about the details and rationale on this thread.

[1.1.0] - 2018-08-28

Changed

  • Extracted scalarDecoder constant and moved to module in the dillonkearns/elm-graphql package. This is only used in generated code. This change allows us to remove all Debug.toString calls in generated code so that users can compile their code with the --optimize flag. This resolves #68.

[1.0.0] - 2018-08-23

Take a look at the dillonkearns/elm-graphql Elm 0.19 upgrade guide.

Removed

  • Subscriptions Low-Level Data-Transfer Layer As before, this library will generate code based on the subscriptions defined in your GraphQL schema. And you will be able to use Graphql.Document.serializeSubscription to get a String that you can send over to your server when you open a subscription. Then you'll be able to use the Graphql.Document.decoder from your subscription to decode the JSON responses from the server. What's been removed is just the low level protocols for doing the websocket connection. As per this issue, this responsibility will be moved out of the core dillonkearns/elm-graphql package in order to decouple this library from the low-level details which differ between different GraphQL server implementations.

The low-level data transfer logic for connecting over websockets to a subscription has been removed from this package. dillonkearns#43

Changed

  • Rename package from dillonkearns/graphqelm to dillonkearns/elm-graphql to follow the elm literal naming convention (see issue #23).

BELOW THIS IS FOR dillonkearns/graphqelm (before the rename to dillonkearns/elm-graphql)

[11.2.0] - 2018-07-02

Added

  • Add Selectionset.fieldSelection function to concisely turn a single Field into a SelectionSet. Thanks to anagrius for the suggestion!

[11.1.0] - 2018-03-21

Added

  • Add mapError and ignoreParsedErrorData functions to allow you to do more manipulation of ParsedData within Error data (fixes #52).

[11.0.0] - 2018-03-21

Changed

  • Responses are errors if any data is present in errors field in response. The data field from the response is also included in GraphqlErrors now so you can inspect the data upon failure. Here is a summary of how this will effect your code:

[10.2.0] - 2018-03-09

Added

  • Add SelectionSet.succeed to provide a hardcoded value as the result of a SelectionSet.

[10.1.0] - 2018-02-25

Changed

  • Expose GraphQL response decoder publicly.

[10.0.0] - 2018-02-07

Changed

  • Update model to allow more flexibility based on #32.

[9.1.0] - 2018-02-06

Added

  • Add functions for transforming Fields using Results. These functions are handy for converting values into types like DateTimes but can cause your entire response to error when decoding if any incorrect assumptions are made so they should be used with extreme care.

[9.0.0] - 2018-01-28

Changed

  • Remove AlwaysPost since Graphql.Http.queryRequest now always uses POST. Added option to GetWhenShortEnough.

Added

  • Add Graphql.OptionalArgument.fromMaybe.
  • Add SelectionSet.map.

[8.0.1] - 2018-01-27

Changed

[8.0.0] - 2018-01-27

Added

  • Add Graphql.Http.withQueryParams.

Changed

  • Use GET requests by default when sending a query request, unless the resulting url would be over 2000 characters. queryParamsForceMethod allows you to specify a method when needed.
  • Rename Graphql.Http functions from buildMutationRequest => mutationRequest and buildQueryRequest => queryRequest to sound more declarative and concise.
  • Extract Subscription.Protocol module which encapsulates the details about low-level subscription communication for a given framework. The module includes an implementation for Rails and Absinthe/Rhoenix, or custom.

[7.2.0] - 2018-01-20

Added

  • Add experimental subscriptions module and example.

[7.1.0] - 2018-01-18

Added

  • Add Graphql.Http.toTask.
  • Expose Graphql.Http.withCredentials.

[7.0.0] - 2018-01-17

Changed

  • Rename FieldDecoder type and module to Field to match GraphQL domain language more closely.

[6.1.0] - 2018-01-11

Added

  • Add hardcoded function to add arbitrary constants alongside with calls.

[6.0.0] - 2018-01-10

Added

  • Expose Http.Error constructors.

[5.0.1] - 2018-01-10

Removed

  • Remove unused elm package dependencies.

[5.0.0] - 2018-01-10

Fixed

  • Add missing Encode.float function. Without this, APIs with float arguments would have compilation errors.

Changed

  • Modules that are used only by generated code are now under Graphql.Internal to make it more clear in the documentation.

[4.1.0] - 2018-01-08

Added

  • Encode functions to support generated code for input objects. There is now no reason for users to consume the Encode module directly! It's all done under the hood by the generated code.

[4.0.1] - 2018-01-07

Fixed

  • Fix bug that excluded arguments when serializing leaves in document.