console/packages/libraries/cli/CHANGELOG.md
TheGuildBot adac87fad9
Upcoming Release Changes (#7310)
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2025-11-25 15:13:49 +00:00

46 KiB

@graphql-hive/cli

0.54.0

Minor Changes

  • #7306 29de664 Thanks @kamilkisiela! - Updated federation-composition to v0.21.0

    • Enhanced auth directive validation: The federation-composition now enforces correct placement of auth directives (@authenticated, @requiresScopes, @policy) by rejecting attempts to place them on interfaces, interface fields, or interface objects with the new AUTH_REQUIREMENTS_APPLIED_ON_INTERFACE validation rule.
    • Transitive auth requirements checking: Added a new validation rule that ensures fields using @requires specify at least the auth requirements of the fields they select. If a field doesn't carry forward required auth directives, composition fails with a MISSING_TRANSITIVE_AUTH_REQUIREMENTS error.
    • Auth requirements inheritance: Interface types and fields now properly inherit @authenticated, @requiresScopes, and @policy directives from the object types that implement them.
    • @cost directive restrictions: The @cost directive can no longer be placed on interface types, their fields, or field arguments. Invalid placements now result in composition errors instead of being silently accepted.
    • Improved @listSize validation: The directive now validates that sizedFields point to actual list fields rather than integer counters. Additionally, slicingArguments validation has been added to ensure only arguments that exist in all subgraphs are retained.
    • Fixed EXTERNAL_MISSING_ON_BASE rule: Resolved false positives when handling @interfaceObject corner-cases, particularly for @external fields on object types provided by interface objects.

0.53.5

Patch Changes

  • Updated dependencies [64c8368]:
    • @graphql-hive/core@0.15.1

0.53.4

Patch Changes

  • Updated dependencies [2cc443c]:
    • @graphql-hive/core@0.15.0

0.53.3

Patch Changes

  • #7264 582bc0e Thanks @n1ru4l! - Ensure http debug logs are printed properly.

  • Updated dependencies [582bc0e]:

    • @graphql-hive/core@0.14.0

0.53.2

Patch Changes

0.53.1

Patch Changes

  • Updated dependencies [d8f6e25]:
    • @graphql-hive/core@0.13.1

0.53.0

Minor Changes

  • #7206 01963a0 Thanks @n1ru4l! - Improve output of the hive whoami command. It now also handles the new access token format.

0.52.1

Patch Changes

  • #7193 543de17 Thanks @adambenhassen! - schema:check --forceSafe now properly approves breaking schema changes in Hive (requires write permission registry token)

0.52.0

Minor Changes

  • #7155 caebbe0 Thanks @jdolle! - add schemaVersionByCommit; update docs and cli; fix webhook commit reference

0.51.0

Minor Changes

0.50.5

Patch Changes

0.50.4

Patch Changes

  • #6919 49187c9 Thanks @jdolle! - fix fallback when hive.json is used but does not provide the requested value

0.50.3

Patch Changes

  • Updated dependencies [8d56b98]:
    • @graphql-hive/core@0.13.0

0.50.2

Patch Changes

  • #6845 114e7bc Thanks @n1ru4l! - Update @theguild/federation-composition to 0.19.0

    Increases federation composition compatibility.

    • Fix errors raised by @requires with union field selection set
    • Fix incorrectly raised IMPLEMENTED_BY_INACCESSIBLE error for inaccessible object fields where the object type is inaccessible.
    • Add support for @provides fragment selection sets on union type fields.
    • Fix issue where the satisfiability check raised an exception for fields that share different object type and interface definitions across subgraphs.
    • Fix issue where scalar type marked with @inaccessible does not fail the composition if all usages are not marked with @inaccessible.
    • Support composing executable directives from subgraphs into the supergraph

0.50.1

Patch Changes

  • Updated dependencies [bbd5643]:
    • @graphql-hive/core@0.12.0

0.50.0

Minor Changes

  • #6658 e6a970f Thanks @n1ru4l! - Internal adjustments for using non-deprecated API fields.

  • #6626 2056307 Thanks @jdolle! - Show dangerous changes as a separate list in schema:check

  • #6662 2b220a5 Thanks @n1ru4l! - Support federation composition validation for IMPLEMENTED_BY_INACCESSIBLE.

  • #6675 ed66171 Thanks @kamilkisiela! - Updates the @theguild/federation-composition to v0.18.1 that includes the following changes:

    • Support progressive overrides (@override(label: "<value>"))
    • Allow to use @composeDirective on a built-in scalar (like @oneOf)
    • Performance improvements (lazy compute of errors), especially noticeable in large schemas (2s -> 600ms)
    • Ensure nested key fields are marked as @shareable
    • Stop collecting paths when a leaf field was reached (performance improvement)
    • Avoid infinite loop when entity field returns itself

Patch Changes

0.49.1

Patch Changes

  • #6633 a5e00f2 Thanks @n1ru4l! - Fix Federation composition error when having an inaccessible default value on an inaccessible field.

  • #6585 c0d9ca3 Thanks @jdolle! - Restrict new service names to 64 characters, alphanumberic, _ and -.

  • Updated dependencies [ee70018, a003f78]:

    • @graphql-hive/core@0.10.1

0.49.0

Minor Changes

  • #6573 3bf0598 Thanks @n1ru4l! - Better error handling for missing --target option when required.

Patch Changes

  • #6582 bb2f2aa Thanks @jdolle! - Adds optional url argument to schema checks

  • Updated dependencies [494697e]:

    • @graphql-hive/core@0.10.0

0.48.3

Patch Changes

0.48.2

Patch Changes

  • #6502 cef7fd8 Thanks @kamilkisiela! - hive dev

    Update @theguild/federation-composition to 0.14.4:

    • Fix a child data type field not being accessible via interfaceObject
    • Respect inaccessible enum values while creating the public schema from the supergraph AST

0.48.1

Patch Changes

  • Updated dependencies [ae2d16d]:
    • @graphql-hive/core@0.9.1

0.48.0

Minor Changes

  • #6488 f7d65fe Thanks @n1ru4l! - Include and log a x-request-id header for all requests sent to the Hive API. This helps users to share more context with Hive staff when encountering errors.

Patch Changes

  • #6483 39eac03 Thanks @n1ru4l! - Show correct error message when attempting a schema check on a federation project without the --service paramater.
  • Updated dependencies [f7d65fe]:
    • @graphql-hive/core@0.9.0

0.47.0

Minor Changes

  • #6449 0504530 Thanks @n1ru4l! - Add --target flag for commands app:create, app:publish, operations:check, schema:check, schema:delete, schema:fetch, schema:publish and dev.

    The --target flag can be used to specify the target on which the operation should be performed. Either a slug or ID of the target can be provided.

    A provided slug must follow the format $organizationSlug/$projectSlug/$targetSlug (e.g. the-guild/graphql-hive/staging).

    Example using target slug

    hive schema:publish --target the-guild/graphql-hive/production ./my-schema.graphql
    

    A target id, must be a valid target UUID.

    Example using target id

    hive schema:publish --target a0f4c605-6541-4350-8cfe-b31f21a4bf80 ./my-schema.graphql
    

    Note: We encourage starting to use the --target flag today. In the future the flag will become mandatory as we are moving to a more flexible approach of access tokens that can be granted access to multiple targets.

0.46.1

Patch Changes

0.46.0

Minor Changes

  • #6357 e10cc2d Thanks @jasonkuhrt! - Add experimental json file flag to command schema:check.

    On the schema:check command, you can now use the flag --experimental-json-file ./path/to/schema-check-result.json to output a JSON file containing the command's result.

    This experimental feature is designed to help you with scripting, typically in CI/CD pipelines.

    Please note that this is an experimental feature, and therefore is:

    1. likely to change or be removed in a future version
    2. not covered by semantic versioning.
  • #6338 f6565fc Thanks @jdolle! - cli schema:fetch targets latest if actionId argument is missing

  • #6333 0a84187 Thanks @jasonkuhrt! - BREAKING: Remove config commands

    This prepares for the addition of JSON format output in other commands.

0.45.0

Minor Changes

  • #6255 29c45df Thanks @jdolle! - Added subgraph type to schema:fetch cmd to print subgraph details

Patch Changes

  • #6252 5a6e565 Thanks @jdolle! - Print a detailed error when a command is executed without a hive access token

  • Updated dependencies [039c66b]:

    • @graphql-hive/core@0.8.3

0.44.5

Patch Changes

  • #6224 592d3b3 Thanks @kamilkisiela! - Extends debug information. Prints a list of files of the script directory and a path of included node binary. To enable debug mode, pass DEBUG=1 environment variable when running the CLI.

0.44.4

Patch Changes

0.44.3

Patch Changes

0.44.2

Patch Changes

  • Updated dependencies [c728803]:
    • @graphql-hive/core@0.8.2

0.44.1

Patch Changes

  • Updated dependencies [be5d39c]:
    • @graphql-hive/core@0.8.1

0.44.0

Minor Changes

  • #5661 ed25aca Thanks @n1ru4l! - Improve error output for rejected app deployment creation. The CLI now shows which operation is affected and the reason for the failed upload.

0.43.0

Minor Changes

  • #5474 3850ad2 Thanks @n1ru4l! - Introduce schema publish retries, when being blocked by other concurrent schema publishes.

0.42.1

Patch Changes

  • Updated dependencies [3ffdb6e]:
    • @graphql-hive/core@0.8.0

0.42.0

Minor Changes

Patch Changes

  • Updated dependencies [a896642]:
    • @graphql-hive/core@0.7.1

0.41.0

Minor Changes

Patch Changes

0.40.1

Patch Changes

  • #5304 f2fef08 Thanks @kamilkisiela! - Fixed a logging issue where both initiated requests and successful responses were being recorded. This was causing the logs to be filled with unnecessary information and affected hive artifact:fetch --artifact command.

  • Updated dependencies [f2fef08]:

    • @graphql-hive/core@0.6.1

0.40.0

Minor Changes

  • #5234 e6dc5c9 Thanks @n1ru4l! - Provide debug logging for HTTP requests when providing the --debug flag.

Patch Changes

  • Updated dependencies [e6dc5c9]:
    • @graphql-hive/core@0.6.0

0.39.0

Minor Changes

  • #5237 c20907b Thanks @kamilkisiela! - Changes the default behavior of hive dev command. Now schema composition is done locally, without substituting subgraphs available in the registry.

    We added --remote flag to the hive dev command to mimic the previous behavior.

    Breaking Change The $ hive dev command is still a work in progress (as stated in the command description). That's why we are not considering this a breaking change, but a minor change.

    Before:

    The hive dev command would substitute subgraphs available in the registry with their local counterparts, performing schema composition over the network according to your project's configuration.

    After:

    The hive dev command will now perform schema composition locally, without substituting subgraphs available in the registry. This is the default behavior.

    To mimic the previous behavior, you can apply the --remote flag and continue using the command as before.

0.38.5

Patch Changes

  • Updated dependencies [f1e43c6]:
    • @graphql-hive/core@0.5.0

0.38.4

Patch Changes

  • #5097 b8998e7 Thanks @kamilkisiela! - Retry up to 3 times a GET request in the artifact:fetch command

  • Updated dependencies [b8998e7]:

    • @graphql-hive/core@0.4.0

0.38.3

Patch Changes

  • Updated dependencies [cbc8364]:
    • @graphql-hive/core@0.3.1

0.38.2

Patch Changes

0.38.1

Patch Changes

0.38.0

Minor Changes

0.37.0

Minor Changes

Patch Changes

0.36.0

Minor Changes

0.35.0

Minor Changes

  • #4383 ff480e9 Thanks @kamilkisiela! - Introducing hive dev command - compose local subgraphs with subgraphs from the registry.

0.34.1

Patch Changes

0.34.0

Minor Changes

0.33.1

Patch Changes

0.33.0

Minor Changes

  • #3543 6895ee3 Thanks @kamilkisiela! - Support Apollo Client directives in operations:check command (pass --apolloClient flag)

0.32.1

Patch Changes

0.32.0

Minor Changes

  • 00520b9 Thanks @n1ru4l! - Print warning when pull request number can not be resolved.

0.31.0

Minor Changes

  • #3359 21d246d Thanks @n1ru4l! - Associate schema checks with context ID for remembering approved breaking schema changes for subsequent schema checks when running the schema:check command.

    If you are using the --github flag, all you need to do is to upgrade to this version. The context will be automatically be the pull request scope.

    On pull request branch GitHub Action:

    hive schema:check --github ./my-schema.graphql
    

    If you are not using GitHub Repositories and Actions, you can manually provide a context ID with the --contextId flag.

    hive schema:check --contextId "pull-request-69" ./my-schema.graphql
    

    Learn more in the product update.

0.30.4

Patch Changes

0.30.3

Patch Changes

  • #3240 6b7aef8b Thanks @dotansimha! - Remove Access to operation:publish information from CLI command "whoami" (unused)

0.30.2

Patch Changes

0.30.1

Patch Changes

0.30.0

Minor Changes

  • #2701 fdf71a1c Thanks @n1ru4l! - Support forwarding GitHub repository information for schema checks and schema publishes when using the --github flag.

    Please upgrade if you want to correctly forward the information for (federated) subgraphs to the Hive registry.

0.29.0

Minor Changes

0.28.0

Minor Changes

  • #2720 79227f8 Thanks @n1ru4l! - Fetch a specific schema sdl or supergraph from the API using the action id (commit sha) with the hive schema:fetch command.

    Example:

    hive schema:fetch 99dad865e1d710b359049f52be0b018 -T supergraph -W supergraph.graphql
    

0.27.1

Patch Changes

0.27.0

Minor Changes

0.26.0

Minor Changes

Patch Changes

0.25.1

Patch Changes

0.25.0

Minor Changes

0.24.0

Minor Changes

Patch Changes

0.23.0

Minor Changes

0.22.0

Minor Changes

0.21.0

Minor Changes

  • #2080 331a1116 Thanks @n1ru4l! - Introduce new config file format. Please move the accessToken property to a registry object.

    The old top-level property approach is now considered deprecated and will no longer be supported in the next major version of the CLI.

     {
    -  "accessToken": "xxxxxd4cxxx980xxxxf3099efxxxxx"
    +  "registry": {
    +      "accessToken": "xxxxxd4cxxx980xxxxf3099efxxxxx"
    +  }
     }
    
  • #2080 331a1116 Thanks @n1ru4l! - Support fetching artifacts from the CDN with hive artifact:fetch.

    See the readme for more information.

Patch Changes

0.20.2

Patch Changes

0.20.1

Patch Changes

0.20.0

Minor Changes

Patch Changes

0.19.12

Patch Changes

0.19.11

Patch Changes

0.19.10

Patch Changes

  • Updated dependencies [e116841]:
    • @graphql-hive/core@0.2.3

0.19.9

Patch Changes

0.19.8

Patch Changes

0.19.7

Patch Changes

0.19.6

Patch Changes

0.19.5

Patch Changes

0.19.4

Patch Changes

0.19.3

Patch Changes

0.19.2

Patch Changes

0.19.1

Patch Changes

0.19.0

Minor Changes

0.18.2

Patch Changes

0.18.1

Patch Changes

  • 41ec31b: Update GraphQL Inspector range to ~3.2.0

0.18.0

Minor Changes

  • 25d6b01: Migrate to Authorization header (previously X-API-Token)

Patch Changes

  • 8035861: Better error messages for SDL syntax errors.

0.17.0

Minor Changes

  • ae6ae2f: Print link to the website when publishing new schema
  • fa5045f: Use graphql@^16.0.0 as direct dependency

0.16.0

Minor Changes

  • 23eb4cc: Add message about empty schema registry in schema:check

0.15.0

Minor Changes

  • 5de7e38: Support SchemaPublishMissingUrlError type

0.14.6

Patch Changes

0.14.5

Patch Changes

  • ad66973: Bump
  • Updated dependencies [ad66973]
    • @graphql-hive/core@0.2.2

0.14.4

Patch Changes

  • 0a5dbeb: Point to graphql-hive.com
  • Updated dependencies [0a5dbeb]
    • @graphql-hive/core@0.2.1

0.14.3

Patch Changes

  • 9e487129: Bump

0.14.2

Patch Changes

  • c87df3ad: Bump

0.14.1

Patch Changes

  • 11958e9d: Add update command to self-update Hive CLI

0.14.0

Minor Changes

  • 6290ec23: Introduce operations:check to validate GraphQL Operations against latest schema
  • 6290ec23: Rename operation:publish command to operations:publish

0.13.0

Minor Changes

  • d5db6070: Support URLs

0.12.0

Minor Changes

  • d9fbd878: Add --github flag to schema:publish command

0.11.0

Minor Changes

  • ac9b868c: Support GraphQL v16
  • e03185a7: GitHub Application

Patch Changes

  • Updated dependencies [ac9b868c]
    • @graphql-hive/core@0.2.0

0.10.0

Minor Changes

  • c5bfa4c9: Add a new metadata flag for publishing schema metadata (JSON) to Hive.

    The --metadata can contain anything you wish to have attached to your GraphQL schema, and can support your runtime needs.

    You can either specify a path to a file: --metadata my-file.json, or an inline JSON object: --metadata '{"test": 1}'.

    Metadata published to Hive will be available as part of Hive CDN, under /metadata route.

0.9.6

Patch Changes

  • 903edf84: Bump

0.9.5

Patch Changes

  • ccb93298: Remove content-encoding header and improve error logs

0.9.4

Patch Changes

  • 28bc8af3: Fix version header

0.9.3

Patch Changes

  • 3a435baa: Show one value of x-request-id

0.9.2

Patch Changes

  • 79d4b4c2: fix(deps): update envelop monorepo

0.9.1

Patch Changes

  • 016dd92c: handle missing service name argument for federation and stitching projects

0.9.0

Minor Changes

  • 7eca7f0: Display access to commands

0.8.1

Patch Changes

  • 273f096: show registry url

0.8.0

Minor Changes

  • 91a6957: Allow to update url of a service

0.7.0

Minor Changes

  • 6f204be: Display token info

0.6.4

Patch Changes

  • 52ab1f2: Find .git directory when CLI is installed globally

0.6.3

Patch Changes

  • 73a840d: Warn about missing git and make git optional

0.6.2

Patch Changes

  • df6c501: Do not exit with 0 when forceSafe

0.6.1

Patch Changes

  • aff0857: Throw on empty schema and use x-request-id as reference

0.6.0

Minor Changes

  • 4647d25: Add --forceSafe flag to mark the check as non-breaking regardless of breaking changes

0.5.0

Minor Changes

  • 0e712c7: Update normalization logic

Patch Changes

  • 0e712c7: Support --url

0.4.9

Patch Changes

  • Updated dependencies [d7348a3]
  • Updated dependencies [d7348a3]
    • @graphql-hive/core@0.1.0

0.4.8

Patch Changes

  • 6214042: Fix auto-update error related to oclif

0.4.7

Patch Changes

  • bda322c: Add --require flag and normalize schema printing

0.4.6

Patch Changes

  • 5aa5e93: Bump

0.4.5

Patch Changes

  • 968614d: Fix persisting the same query twice
  • 968614d: Add auto-updates and new-version warnings

0.4.4

Patch Changes

  • 1a16360: Send GraphQL Client name and version

0.4.3

Patch Changes

  • 41a9117: Fix an issue when publishing a schema for the first time

0.4.2

Patch Changes

  • c6ef3d2: Bob update
  • 4224cb9: Support HIVE_* env variables
  • Updated dependencies [c6ef3d2]
    • @graphql-hive/core@0.0.5

0.4.1

Patch Changes

  • aa12cdc: Use process.cwd()
  • aa12cdc: Use HIVE_SPACE instead of REGISTRY_KEY env var

0.4.0

Minor Changes

  • e8dc8c6: Move file to be an argument, fix config

0.3.2

Patch Changes

  • 85b85d4: Dependencies update, cleanup, ui fixes

0.3.1

Patch Changes

  • Updated dependencies [4a7c569]
    • @graphql-hive/core@0.0.4

0.3.0

Minor Changes

  • 34cff78: Added support for specifying multiple configs in hive json file

0.2.1

Patch Changes

  • e257a0d: Support relay-like outputs of persisted operations
  • bb5b3c4: Preparations for persisted operations in Lance

0.2.0

Minor Changes

  • acab74b: Added support for persisted operations - Changes made in API, APP, CLI, Server, Storage

0.1.1

Patch Changes

  • 79fe734: Set default registry url

0.1.0

Minor Changes

  • 078e758: Token per Target
  • 1dd9cdb: --file flag is now replaced with a positional arg at the end, comments in graphql sdl files are now converted to descriptions, docs are updated to mention wildcard file uploads

Patch Changes

  • 60cd35d: Use default endpoint

0.0.5

Patch Changes

  • d433269: Fixes

0.0.4

Patch Changes

  • d64a3c5: Target 2017

0.0.3

Patch Changes

  • 7e88e71: bump

0.0.2

Patch Changes

  • b2d686e: bump