Bug Fixes

• console.log in resolvers no longer results in failed invocation errors.

Features

• Add id filter to the collection query.
• Add regex filter to the search query.
• grafbase dev now logs GraphQL operations that the server
  receives
• Added the ability to exclude fields from the types generated by
  OpenAPI & GraphQL connectors
• Resolvers can now throw GraphQL error to return an error to users in the
  API response

Changes

• You no longer have to use the extend keyword when adding resolvers to
  Query & Mutation in SDL

Bug Fixes

• OpenAPI namespaces are correctly camelCased.

Features

• Add create, update and delete batch mutations. So for a type Post we have postCreateMany, postUpdateMany and postDeleteMany.
• OpenAPI & GraphQL connectors can now forward headers from clients

Bug fixes

• For update mutations, like postUpdate, nullable fields can now be set to null. Previously, those updates
  were ignored.
• Improved support for v2 of the OpenAPI specification.
• Fixed an issue where errors during resolver startup would not be shown

Features

• Add create and update batch operations postCreateMany and postUpdateMany.
• OpenAPI & GraphQL connectors can now forward headers from clients (currently
  via SDL configuration only).

Bug fixes

• For update mutations, like postUpdate, nullable fields can now be set to
  null. Previously, those updates would be ignored.
• Improved support for v2 of the OpenAPI specification.

Fixes

• Fixes an issue introduced in 0.26.1 that would cause an infinite reinstallation of dependencies if package.json was located in the grafbase/ directory.

Changes

• Change the working directory in which resolver builds take place allowing them to import files relative to the project directory

Bug Fixes

• Fixed allOf schema support in @openapi
• JSON scalars will now accept any literal Value in documents

Bug Fixes

• Fixed an issue with live queries not returning data
• Added the missing description field to __Schema in introspeciton.
• Fixed the __type field in introspection
• Custom resolver fields on @graphql types are no longer sent to downstream
  servers
• @graphql now pulls in an objects interfaces correctly
• Type conditions on inline & fragment spreads now match interfaces correctly
• Type conditions on unions will now match if the condition is the union type
  itself

Bug Fixes

• Fixed the linux x86 build of the grafbase CLI

Features

• Adds support for arm64 Linux
• Adds experimental support for custom "authorizer" providers, configured using
  providers: [{ type: authorizer, name: "some-file-name" }]

Changes

• Resolver build errors will now be shown to users

Bug Fixes

• Fixes an issue where the GraphQL connector wouldn't forward variables
  to downstream servers.

Features

• Adds support for arm64 Linux

Fixes

• Using typescript templates adds to the package.json accordingly

Fixes

• OpenAPI name attribute is now namespace, and is optional
• Update crates
• Fix grafbase init -c typescript on folders starting with a dot
• Fix the CLI failing to start in server mode on some Windows installations

Features

• Make GraphQL Connector namespacing optional
• Add replace payment method endpoint to allow clients to change their payment
  method
• Move to lazy compilation of resolvers in local dev

Fixes

• Add an error message if package.json missing while grafbase.config.ts present
• Resolve issues with namespace-less GraphQL connector queries
• Make error message verification more generic
• Fix custom resolvers on Windows
• Ignore deployment files from blacklist
• Adds new error variants to the create operation
• Output the name of unknown API errors

Fixes

• Resolve issues with namespace-less GraphQL connector queries

Features

• Make GraphQL Connector namespacing optional
• Add replace payment method endpoint to allow clients to change their payment
  method

Fixes

• Add an error message if package.json missing while grafbase.config.ts present

Features

• Adds support for privacy preserving anonymous analytics

  • Does not include or store any PII

  • Compile time checks

    • Checks for GRAFBASE_RUDDERSTACK_WRITE_KEY and GRAFBASE_RUDDERSTACK_DATAPLANE_URL (CI secrets) to enable analytics

  • Runtime checks

    • Checks for DO_NOT_TRACK and disables analytics if found with any value
    • Checks $HOME/.grafbase/config.json and disables analytics if enableAnalytics is set to false

  • Added context:

    {
      "anonymousId": "..." // anonymous ULID, stored between sessions. not linked to anything.
      "sessionId": "...", // anonymous ULID, generated once per session. not linked to anything.
      "startTime": "...", // ISO 8601 timestamp
      "version": "..." // semantic version
    }
    

  • Current events:

    • "Command Executed" - Sends the name and arguments (argument names only, omits values!) of the currently used command. We use this to understand which features are being used.

    • Example payload (sent for gb dev --port 3999 --search)

      {
        "anonymousId": "01H1M2NKXQZC0XYK7NAFYBK6JZ",
        "channel": "server",
        "context": {
          "library": {
            "name": "RudderStack Rust SDK",
            "version": "1.0.0"
          },
          "sessionId": "01H1M2Y2SBSCVA3WMYNTNRTNFR",
          "startTime": "2023-05-29T15:44:53.547629Z",
          "version": "0.21.1"
        },
        "event": "Command Executed",
        "messageId": "0b4c14a8-39ac-45ed-b0d3-61d534b22149",
        "originalTimestamp": "2023-05-29T15:44:53.548544Z",
        "properties": {
          "commandArguments": "port,search",
          "commandName": "dev"
        },
        "rudderId": "1a0dfe06-e5aa-4762-8a55-bc039327cb13",
        "sentAt": "2023-05-29T15:44:53.548544Z",
        "type": "track"
      }
      

  • Opting out (may be a command later on):

    • Option 1: Write / modify the following properties in $HOME/.grafbase/config.json:

      {
        "analyticsEnabled": false,
        "anonymousId": null
      }
      

    • Option 2: Set the DO_NOT_TRACK environment variable with any value (this may affect other tooling that checks for DO_NOT_TRACK)

Fixes

• Fixes an issue where login and logout could only be run in projects
• Fixes an issue where create would not ask project info if run without parameters
• Fixes Windows env var generation
• Defaults to y in the create confirmation prompt
• Creates $PROJECT/.grafbase if it does not exist when linking
• Allows connector types to be extended
• Doesn't error on missing nullable objects in the GraphQL connector
• Fixes a possible internal error when unlinking entities

Fixes

• Fixes a panic when running login and logout
  • Note: temporarily these commands will only work within a project folder, this will be fixed in a future release