@glion/cli

The glion command — development and production runtime for Glion MLLP applications.

What it does

@glion/cli provides the glion binary that runs Glion applications. A single-file MLLP app exported as export default new Mllp() becomes a running server with glion dev (for development with live reload and a terminal UI) or glion start (for production with graceful shutdown and structured logs). The CLI reads configuration from a glion.config.ts file when present or infers defaults when not.

Install

npm install @glion/cli

Use

Define your app in a single file:

// glion.app.ts
import { parseHL7v2 } from "@glion/hl7v2";
import { Mllp } from "@glion/mllp";
import { ackMiddleware } from "@glion/mllp-ack";

export default new Mllp()
  .parser(parseHL7v2)
  .use(ackMiddleware())
  .on("ADT^A01", handleAdmit)
  .on("ORU^R01", handleResult);

Add the two scripts to package.json:

{
  "scripts": {
    "dev": "glion dev",
    "start": "glion start"
  }
}

Run npm run dev during development. Run npm start in production.

API

defineConfig(config)

Identity helper for glion.config.ts that gives TypeScript inference over the configuration schema:

// glion.config.ts
import { defineConfig } from "@glion/cli/config";

export default defineConfig({
  entry: "./src/app.ts",
  port: 2575,
  hostname: "0.0.0.0",
});

GlionConfig

Type exported from @glion/cli/config:

Commands

glion dev

Runs the app with live reload. Watches the entry file and any paths listed in watch, cold-restarts on change, and renders a live terminal UI showing request/response counts, uptime, and error summaries. Falls back to log-only mode when stdout is not a TTY (CI, piped output).

glion start

Runs the app in production. Emits JSON-line events to stdout for log aggregators, handles SIGTERM with a graceful drain (gracefulCloseMs, default 5000), and exits cleanly when the drain completes.

Zero-config mode

Both commands work without a glion.config.ts when the app file is at ./glion.app.ts at the project root. The TUI shows a zero-config badge to indicate no config was loaded. Create a glion.config.ts when you need custom ports, TLS, or additional watch paths.

Cross-runtime invocation

The glion binary ships with #!/usr/bin/env node. Bun and Deno require explicit opt-in:

Part of Glion

@glion/cli is part of Glion, the application framework for HL7v2. See the Glion README for the full package catalog and architecture.