@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:

| Field | Type | Description | | ----------------- | ------------------------------- | -------------------------------------------------------------------- | | entry | string | Path to the app file. Defaults to ./glion.app.ts when unspecified. | | port | number | Port to listen on. Defaults to 2575 (the MLLP standard). | | hostname | string | Interface to bind. Defaults to 0.0.0.0. | | tls | { cert: string; key: string } | Enable MLLP over TLS. | | watch | string[] | Additional paths the dev watcher should reload on. | | gracefulCloseMs | number | Drain timeout for glion start. Defaults to 5000. |

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:

| Runtime | Invocation | | ------- | ------------------------------------------------------------------- | | Node | npm run dev / npm start / npx glion dev | | Bun | bun --bun run dev (package.json script) or bunx --bun glion dev | | Deno | deno task dev with a deno.json task that runs the bin |

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.