Neurotic Pantaloon Maker

    @bustle/graphql-loader
    TypeScript icon, indicating that this package has built-in type declarations

    1.1.0 • Public • Published

    GraphQL Loader for Webpack

    A webpack loader for .graphql file query documents. Supports imports, outputting as strings or document ASTs, schema validation, and query hashing.

    This was originally forked from https://github.com/samsarahq/graphql-loader & then heavily modified. Thank you to the authors.

    Installation

    npm install --save-dev @bustle/graphql-loader

    Configuration

    Add the loader to your webpack config:

    module.exports = {
      // ...
      module: {
        rules: [
          {
            test: /\.graphql$/,
            use: [
              {
                loader: '@bustle/graphql-loader',
                options: {
                  // See "Loader Options" below
                }
              }
            ]
          }
        ]
      }
    }

    Loader Options

    schema (string)

    The path to your graphql introspection query schema JSON file. If used with the validate option, this will be used to validate imported queries and fragments.

    validate (boolean) (default=false)

    If true, the loader will validate the imported document against your specified schema file.

    output ("string" | "document") (default="string")

    Specifies whether or not the imported document should be a printed graphql string, or a graphql DocumentNode AST.

    minify (boolean) (default=false)

    If true and the output option is string, the loader will strip comments and whitespace from the graphql document strings. This helps to reduce bundled code size.

    removeUnusedFragments (boolean) (default=false)

    If true, the loader will remove unused fragments from the imported document. This may be useful if a query is importing fragments from a file, but does not use all fragments in that file.

    hash (boolean | "replace") (default=false)

    If true, exports an additional constant named hash which is a sha256 hash of the query contents. This can be used for persisted queries.

    If 'replace' is specified, the default export will be replaced with the hash instead of exporting the query. Useful in a production environment if your server is aware of the persisted hashes and you don't want to bundle the queries.

    hashFunction (function) (default=defaultHashFunction)

    If using the hash option, you can supply a custom hashing function. If not specified, uses node crypto.

    Plugin

    If you use the hash options of the loader for persisted queries, you can optionally add the companion plugin which will output a json manifest of all the queries with their corresponding hash. You could then use this manifest to prime your server with the persisted queries.

    const { GraphQLLoaderPlugin } = require('@bustle/graphql-loader')
    module.exports = {
      // ...
      plugins: [
        new GraphQLLoaderPlugin({
          manifestFilename: 'graphql-hash-manifest.json' // Optional filename option. This is the default
        })
      ]
    }

    Import statements in .graphql files

    The loader supports importing .graphql files from other .graphql files using an #import statement. For example:

    query.graphql:

    #import "./fragments.graphql"
    
    query {
      ...a
      ...b
    }

    fragments.graphql:

    fragment a on A {}
    fragment b on A {
      foo(bar: 1)
    }

    In the above example, fragments a and b will be made available within query.graphql. Note that all fragments in the imported file should be used in the top-level query, or the removeUnusedFragments should be specified.

    Install

    npm i @bustle/graphql-loader

    DownloadsWeekly Downloads

    466

    Version

    1.1.0

    License

    MIT

    Unpacked Size

    17.2 kB

    Total Files

    10

    Last publish

    Collaborators

    • eggplantkiller
    • tholman
    • teety
    • tylerlove
    • zeejab
    • anujpan
    • gdub
    • bustle-deploy
    • redterror
    • wabyad
    • sarahganis
    • cg3ntry