@freshsqueezed/mammothgql

@freshsqueezed/mammothgql

A TypeScript/JavaScript GraphQL middleware for express

Getting started: Express middleware

Mammoth GQL enables the ability to add middleware that lets you run your GraphQL server as part of an app built with Express, one of the most popular web frameworks for Node.

First, install MammothGQL Middleware, the JavaScript implementation of the core GraphQL algorithms, Express, and two common Express middleware packages:

npm install @afreshsqueezed/mammothgql graphql @graphql-tools/schema express cors

Then, write the following to ./src/app.ts.

import express, { json } from 'express';
import cors from 'cors';
import mammoth from '@freshsqueezed/mammothgql';
import { ServerContext } from './types';
import schema from './graphql';

const app = express();

app.use(cors());
app.use(json());
app.use(
  '/graphql',
  mammoth<ServerContext>({
    schema,
    graphiql: true,
    context: ({ req }) => ({
      user: req.user || null,
    }),
  }),
);

export default app;

Create a ./src/index.ts file and

import { createServer } from 'node:http';
import app from './app';

const httpServer = createServer(app);

httpServer.listen(3000, () => {
  console.log(`
🚀 Server is running on http://localhost:${PORT}/graphql
  `);
});

Now run your server with:

ts-node ./src/index.ts

Open the URL it prints in a web browser. It will show GraphiQL, a web-based tool for running GraphQL operations. Try running the operation query { hello }!

Changelog

1.0.3 (2024-11-26)

Bug Fixes

• add new filter function (fa97bd2)
• update middleware (54609c8)