grafbase

Breaking

• Removes the fallback to $PROJECT/.grafbase as the home directory if no specific home directory is specified and the user home directory can not be found

Features

• Allows setting the location of the configuration directory by either setting --home (gb --home path/to/dir dev / login / create / ...) or the GRAFBASE_HOME environment variable.
  • Note: /.grafbase is appended to either of these if used
  • Note: --home takes precedence over GRAFBASE_HOME if both are specified, and both override the default user home directory
• Adds @graphql directive header pass-through

Fixes

• Stops manually initializing the environment when running reset
• Fixes OIDC discovery URL handling containing path, enabling using Azure AD
• Fixes an issue with live queries

Breaking

• Removes the fallback to $PROJECT/.grafbase as the home directory if no specific home directory is specified and the user home directory can not be found

Features

• Allows setting the location of the configuration directory by either setting --home (gb --home path/to/dir dev / login / create / ...) or the GRAFBASE_HOME environment variable.
  • Note: /.grafbase is appended to either of these if used
  • Note: --home takes precedence over GRAFBASE_HOME if both are specified, and both override the default user home directory

Fixes

• Stops manually initializing the environment when running reset

Bug Fixes

• Fix OIDC discovery URL handling containing path, enabling using Azure AD

Features

• Adds a @graphql directive to support generating queries and mutations from upstream GraphQL APIs.
• Adds a JWKS auth provider.
• Adds initial support for TypeScript configuration.

Bug Fixes

• Fix floating point handling in the DynaQL queries and responses
• Fix more deployment memory issues

A re-release of 0.20.0-rc.5

Fixes

• fix GraphQL input type introspection stringification

Fixes

• fix GraphQL input type introspection stringification

Enhancements

• use camelCase for @graphql directive field name

A re-release of 0.20.0-rc.1

Features

• Adds a @graphql directive to support generating queries and mutations from upstream GraphQL APIs
• Adds a JWKS auth provider
• Adds initial support for TypeScript configurations

A re-release of 0.19.1

Changes

• The url parameter to @openapi is no longer required if the schema
  contains a URL.
• @openapi now supports the older v2 of OpenAPI.
• @openapi can now send headers when fetching a schema. These are specified
  in the introspectionHeaders parameter.

Bug Fixes

• Defaults on OpenAPI enums now work correctly.
• Significantly reduced memory use of introspection queries.

Changes

• The url parameter to @openapi is no longer required if the schema
  contains a URL.
• @openapi now supports the older v2 of OpenAPI.
• @openapi can now send headers when fetching a schema. These are specified
  in the introspectionHeaders parameter.

Bug Fixes

• Defaults on OpenAPI enums now work correctly.
• Significantly reduced memory use of introspection queries.

Features

• Allows passing arguments to create rather than using interactive input

  Usage: grafbase create [OPTIONS]
  
  Options:
  -n, --name <name>       The name to use for the new project
  -a, --account <slug>    The slug of the account in which the new project should be created
  -r, --regions <region>  The regions in which the database for the new project should be created
  -h, --help              Print help
  

• Supports passing a GRAFBASE_ACCESS_TOKEN environment variable rather than logging in (e.g. for CI environments)

  • Note: being logged in via grafbase login takes precedence over supplying GRAFBASE_ACCESS_TOKEN

Fixes

• Fixes a few cases of output to STDERR instead of STDOUT

Fixes

• Fixes the introspection query when a schema has @openapi and uses the
  JSON scalar.
• Fixes an issue with by ID queries when using owner based auth.

Fixes

• Fixes the wording of an error message when logged out

Fixes

• The watcher now correctly allows server errors to be emitted and stop the reload loop
• Node version support is now enforced only by the CLI rather than in package.json as well
• Resolvers now emit error logs on exceptions

Bug Fixes

• Union types generated by @openapi now return the correct typename.
• Fragment selections on union types generated by @openapi now return data.
• @openapi unions generated from oneOf or anyOf schemas containing a
  scalar now expose that scalar as one of the variants of the union.

Bug Fixes

• Fix auto-generated update mutation for @model types with @default fields. The
  mutation would re-apply the default values and break in some cases

Bug Fixes

• Input objects used by custom resolvers no longer removed from the final schema.
• The parent argument to custom resolvers is now populated in by ID queries.
• The OpenAPI connector now supports shared operation parameters.
• The OpenAPI connector now supports more HTTP methods

Fixes

• Fixes a panic on invalid KvStore identifier during OIDC verification.
• Interpolated path is now used to reference the assets, fixes the dev command on crates.io releases

Breaking

• The location of the local database was moved to a subfolder and will reset after this update

Features

• Adds an @openapi directive that generates queries and mutations that call an API described by an OpenAPI specification.
• Added grafbase login & grafbase logout commands
• Adds a create command to setup and deploy a new project from the command line.
• Adds a deploy command to deploy a project from the command line.
• Add initial support for custom resolvers written in JavaScript or TypeScript.
• Add unlink and link commands.
• Change the auth configuration to require an API key in the locally running gateway.
• Allow environment variables to be interpolated in any string in the schema.
• Continues reloading on schema, resolver and environment variable errors while displaying an error page instead of the playground and returning the compilation error when attempting to call the API endpoint
• Supports the new Grafbase playground
• OpenAPI support improvements
  • Default value support
  • General improvements
• Allows the combination of owner-based auth rules with private/group-based rules in the global scope
• Creates a .env file when running init

Fixes

• Fixes a panic in schema parsing if a users type had underscores in its name.
• Fixes a panic in schema parsing if the name of a users type clashed with a generated type.
• Fixes a panic when a missing input argument is passed to a mutation
• The top level namespacing @openapi types are no longer optional.
• The names of @openapi queries have been improved for APIs with well
  structured specifications
• The names of @openapi union types have been improved.
• All CLI output is now capitalized into sentence case
• Exit codes from the CLI are no longer compatibel with sysexit
• Environment variables are now supported in all string arguments to @openapi
• OpenAPI specifications will no longer select responses that aren't
  application/json
• Fixed some inefficiencies in handling introspection queries
• Update the expected resolvers' signature from ({ parent, args, context, info }) to (parent, args, context, info)
• Build resolvers concurrently.
• Adjust the output messaging when resolvers are being built.
• Reduce memory consumption required in schema introspection.
• Resolver output tweaks
• Prevents reset from removing link files
• Allows introspection without auth locally
• Prevents an issue with create when the .grafbase folder didn't previously exist
• Adds additional API error hints

Breaking

• The location of the local database was moved to a subfolder and will reset after this update

Features

• Supports the new Grafbase playground
• OpenAPI support improvements
  • Default value support
  • General improvements
• Allows the combination of owner-based auth rules with private/group-based rules in the global scope

Fixes

• Prevents reset from removing link files
• Allows introspection without auth locally
• Prevents an issue with create when the .grafbase folder didn't previously exist