@morphql/server

A headless transformation server core for MorphQL. Designed to be embedded into existing NestJS or Node.js applications to provide managed transformation endpoints with caching and OpenAPI support.

Core Features

• 🏗️ Headless Core: Embed MorphQL management into your own backend.
• 🔗 Staged Queries: Map .morphql files to named API endpoints automatically.
• ⚡ Redis Integration: Strategic caching of compiled queries for maximum throughput.
• 📖 Auto-OpenAPI: Generates Swagger/OpenAPI fragments for all defined transformations.
• 🛡️ Type-Safe: Inferred schemas for request and response formats.

Installation

npm install @morphql/server @morphql/core

Basic Usage (NestJS/Node)

import { MorphServer } from '@morphql/server';

const morph = new MorphServer({
  queriesDir: './queries', // automatically load .morphql files
  cache: redisCache, // optional Redis caching
});

await morph.initialize();

// Execute a named staged query
const result = await morph.executeStaged('user-profile', sourceData);

Standalone Usage

If you need a ready-to-deploy microservice, check the Server Instance Starter Template in our repository. It includes:

• Docker & Docker Compose setup
• Pre-configured NestJS application
• Health checks (Liveness/Readiness)
• API Key authentication

Learn More

• 👉 Official Documentation
• 🏠 Main Repository

License

MIT