@lagz0ne/nats-embedded 0.2.0 → 0.3.1

package/README.md

@@ -2,6 +2,8 @@
 
 Embedded [NATS](https://nats.io) server for Node.js and Bun. Bundles the official `nats-server` binary as a managed child process with automatic random port allocation — zero conflicts, zero configuration.
 
+Works with both ESM and CommonJS.
+
 ## Install
 
 ```bash
@@ -23,17 +25,72 @@ console.log(server.url); // nats://127.0.0.1:52431
 await server.stop();
 ```
 
+CommonJS:
+
+```javascript
+const { NatsServer } = require('@lagz0ne/nats-embedded');
+```
+
 ## Options
 
+All nats-server CLI flags are exposed as typed options. No guards — NATS validates.
+
+```typescript
+const server = await NatsServer.start({
+  // Server
+  port: -1,                // -1 = random (default), 0 = nats default (4222)
+  host: '127.0.0.1',      // default: localhost only
+  serverName: 'my-server', // default: auto-generated
+
+  // JetStream
+  jetstream: true,
+  storeDir: '/tmp/js',
+
+  // WebSocket
+  websocket: true,         // random port, no TLS (embedded defaults)
+  // or: websocket: { port: 8080, noTls: false }
+
+  // Auth
+  user: 'admin',
+  pass: 'secret',
+  token: 'auth-token',
+
+  // TLS
+  tls: true,
+  tlsCert: '/path/to/cert.pem',
+  tlsKey: '/path/to/key.pem',
+
+  // Logging
+  debug: true,             // NATS -D flag
+  trace: true,             // NATS -V flag
+  verbose: true,           // forward nats-server stderr to process.stderr
+
+  // Monitoring
+  httpPort: 8222,
+
+  // Escape hatches
+  config: './nats.conf',   // custom config file
+  args: [],                // extra CLI arguments
+});
+```
+
+## WebSocket
+
 ```typescript
+const server = await NatsServer.start({ websocket: true });
+
+console.log(server.wsUrl);  // ws://127.0.0.1:54322
+console.log(server.wsPort); // 54322
+
+// Full control over websocket config block
+const server = await NatsServer.start({
+  websocket: { port: 8080, noTls: false },
+});
+
+// Combined with custom config file (your file takes precedence)
 const server = await NatsServer.start({
-  port: -1,              // -1 = random (default), 0 = nats default (4222)
-  host: '127.0.0.1',    // default: localhost only
-  jetstream: true,       // enable JetStream (default: false)
-  storeDir: '/tmp/js',   // JetStream storage directory
-  debug: false,          // forward nats-server logs to stderr
-  config: './nats.conf', // custom config file
-  args: [],              // extra CLI arguments
+  websocket: true,
+  config: './my-nats.conf',
 });
 ```
 
@@ -41,7 +98,7 @@ const server = await NatsServer.start({
 
 ### `NatsServer.start(opts?): Promise<NatsServer>`
 
-Starts a new nats-server process. Resolves when the server is listening.
+Starts a new nats-server process. Resolves when all listeners are ready.
 
 ### `server.url: string`
 
@@ -49,7 +106,15 @@ NATS connection URL (e.g. `nats://127.0.0.1:52431`).
 
 ### `server.port: number`
 
-Assigned port number.
+Assigned TCP port number.
+
+### `server.wsUrl?: string`
+
+WebSocket URL (e.g. `ws://127.0.0.1:54322`). Undefined if websocket not enabled.
+
+### `server.wsPort?: number`
+
+WebSocket port. Undefined if websocket not enabled.
 
 ### `server.stop(): Promise<void>`
 

package/dist/index.cjs

@@ -0,0 +1,238 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let node_child_process = require("node:child_process");
+let node_fs = require("node:fs");
+let node_path = require("node:path");
+let node_os = require("node:os");
+let node_module = require("node:module");
+let node_url = require("node:url");
+//#region src/resolve.ts
+const PLATFORM_MAP = {
+	"linux-x64": "@lagz0ne/nats-embedded-linux-x64",
+	"linux-arm64": "@lagz0ne/nats-embedded-linux-arm64",
+	"darwin-x64": "@lagz0ne/nats-embedded-darwin-x64",
+	"darwin-arm64": "@lagz0ne/nats-embedded-darwin-arm64",
+	"win32-x64": "@lagz0ne/nats-embedded-win32-x64",
+	"win32-arm64": "@lagz0ne/nats-embedded-win32-arm64"
+};
+const BINARY_NAME = (0, node_os.platform)() === "win32" ? "nats-server.exe" : "nats-server";
+function resolve() {
+	if (process.env.NATS_EMBEDDED_BINARY) return process.env.NATS_EMBEDDED_BINARY;
+	const key = `${(0, node_os.platform)()}-${(0, node_os.arch)()}`;
+	const pkg = PLATFORM_MAP[key];
+	if (!pkg) throw new Error(`Unsupported platform: ${key}. Supported: ${Object.keys(PLATFORM_MAP).join(", ")}`);
+	try {
+		return (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href).resolve(`${pkg}/${BINARY_NAME}`);
+	} catch {
+		const sibling = (0, node_path.join)((0, node_path.dirname)((0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href)), "..", "..", key, BINARY_NAME);
+		if ((0, node_fs.existsSync)(sibling)) return sibling;
+		throw new Error(`Cannot find nats-server binary. Install ${pkg} or set NATS_EMBEDDED_BINARY`);
+	}
+}
+//#endregion
+//#region src/parse.ts
+function parsePort(line) {
+	const match = line.match(/Listening for client connections on .+:(\d+)/);
+	return match ? parseInt(match[1], 10) : null;
+}
+function parseWsPort(line) {
+	const match = line.match(/Listening for websocket clients on .+:(\d+)/);
+	return match ? parseInt(match[1], 10) : null;
+}
+//#endregion
+//#region src/config.ts
+function toSnakeCase(str) {
+	return str.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);
+}
+function serializeBlock(name, obj) {
+	return `${name} {\n${Object.entries(obj).map(([k, v]) => {
+		const key = toSnakeCase(k);
+		if (typeof v === "string") return `  ${key}: "${v}"`;
+		return `  ${key}: ${v}`;
+	}).join("\n")}\n}`;
+}
+const WS_DEFAULTS = {
+	port: -1,
+	no_tls: true
+};
+function buildConfig(opts) {
+	if (!opts.websocket) return null;
+	const parts = [serializeBlock("websocket", opts.websocket === true ? { ...WS_DEFAULTS } : {
+		...WS_DEFAULTS,
+		...opts.websocket
+	})];
+	if (opts.config) parts.push(`include '${(0, node_path.resolve)(opts.config)}'`);
+	return parts.join("\n\n") + "\n";
+}
+//#endregion
+//#region src/index.ts
+/**
+* Maps option keys to their nats-server CLI flags.
+* - boolean options: flag is pushed only when true
+* - string/number options: flag + value
+* - string[] options: flag + comma-joined value
+*
+* Keys not in this map are handled separately (host, port, verbose, websocket, config, args).
+*/
+const FLAG_MAP = {
+	serverName: "--server_name",
+	pidFile: "-P",
+	httpPort: "-m",
+	httpsPort: "-ms",
+	clientAdvertise: "--client_advertise",
+	portsFileDir: "--ports_file_dir",
+	debug: "-D",
+	trace: "-V",
+	log: "-l",
+	logtime: "-T",
+	syslog: "-s",
+	remoteSyslog: "-r",
+	logSizeLimit: "--log_size_limit",
+	maxTracedMsgLen: "--max_traced_msg_len",
+	jetstream: "-js",
+	storeDir: "-sd",
+	user: "--user",
+	pass: "--pass",
+	token: "--auth",
+	tls: "--tls",
+	tlsCert: "--tlscert",
+	tlsKey: "--tlskey",
+	tlsVerify: "--tlsverify",
+	tlsCaCert: "--tlscacert",
+	routes: "--routes",
+	cluster: "--cluster",
+	clusterName: "--cluster_name",
+	noAdvertise: "--no_advertise",
+	clusterAdvertise: "--cluster_advertise",
+	connectRetries: "--connect_retries",
+	clusterListen: "--cluster_listen",
+	profile: "--profile"
+};
+function buildArgs(opts, configPath) {
+	const host = opts.host ?? "127.0.0.1";
+	const port = opts.port ?? -1;
+	const args = [
+		"-a",
+		host,
+		"-p",
+		String(port)
+	];
+	for (const [key, flag] of Object.entries(FLAG_MAP)) {
+		const val = opts[key];
+		if (val === void 0 || val === false) continue;
+		if (val === true) args.push(flag);
+		else if (Array.isArray(val)) args.push(flag, val.join(","));
+		else args.push(flag, String(val));
+	}
+	if (configPath) args.push("-c", configPath);
+	else if (opts.config) args.push("-c", opts.config);
+	if (opts.args) args.push(...opts.args);
+	return args;
+}
+var NatsServer = class NatsServer {
+	/** Full NATS connection URL (e.g. nats://127.0.0.1:52431) */
+	url;
+	/** Assigned port */
+	port;
+	/** WebSocket port (undefined if websocket not enabled) */
+	wsPort;
+	/** WebSocket URL (undefined if websocket not enabled) */
+	wsUrl;
+	/** Resolves with the exit code when the process exits (for crash detection) */
+	exited;
+	proc;
+	configDir;
+	constructor(proc, host, port, wsPort, configDir) {
+		this.proc = proc;
+		this.port = port;
+		this.url = `nats://${host}:${port}`;
+		if (wsPort !== void 0) {
+			this.wsPort = wsPort;
+			this.wsUrl = `ws://${host}:${wsPort}`;
+		}
+		this.configDir = configDir;
+		this.exited = new Promise((res) => {
+			proc.on("exit", (code) => res(code));
+		});
+	}
+	static async start(opts = {}) {
+		const bin = resolve();
+		const host = opts.host ?? "127.0.0.1";
+		const needWs = !!opts.websocket;
+		let configDir = null;
+		let configPath;
+		const configContent = buildConfig(opts);
+		if (configContent) {
+			configDir = (0, node_fs.mkdtempSync)((0, node_path.join)((0, node_os.tmpdir)(), "nats-embedded-"));
+			configPath = (0, node_path.join)(configDir, "nats.conf");
+			(0, node_fs.writeFileSync)(configPath, configContent);
+		}
+		const proc = (0, node_child_process.spawn)(bin, buildArgs(opts, configPath), { stdio: [
+			"ignore",
+			"ignore",
+			"pipe"
+		] });
+		const result = await new Promise((resolve, reject) => {
+			const timeout = setTimeout(() => {
+				proc.kill("SIGKILL");
+				reject(/* @__PURE__ */ new Error("nats-server did not start within 5s"));
+			}, 5e3);
+			proc.on("error", (err) => {
+				clearTimeout(timeout);
+				reject(err);
+			});
+			proc.on("exit", (code) => {
+				clearTimeout(timeout);
+				reject(/* @__PURE__ */ new Error(`nats-server exited with code ${code} before ready`));
+			});
+			let tcpPort = null;
+			let wsPort = null;
+			let resolved = false;
+			let buffer = "";
+			proc.stderr.on("data", (chunk) => {
+				const text = chunk.toString();
+				if (opts.verbose) process.stderr.write(text);
+				if (resolved) return;
+				buffer += text;
+				const lines = buffer.split("\n");
+				buffer = lines.pop();
+				for (const line of lines) {
+					const tcp = parsePort(line);
+					if (tcp !== null) tcpPort = tcp;
+					const ws = parseWsPort(line);
+					if (ws !== null) wsPort = ws;
+					if (tcpPort !== null && (!needWs || wsPort !== null)) {
+						resolved = true;
+						clearTimeout(timeout);
+						proc.removeAllListeners("exit");
+						resolve({
+							tcpPort,
+							wsPort: wsPort ?? void 0
+						});
+						return;
+					}
+				}
+			});
+		});
+		return new NatsServer(proc, host, result.tcpPort, result.wsPort, configDir);
+	}
+	/** Gracefully stop the server (SIGTERM → 5s timeout → SIGKILL) */
+	async stop() {
+		if (this.proc.exitCode !== null) return;
+		this.proc.kill("SIGTERM");
+		if (!await Promise.race([this.exited.then(() => true), new Promise((r) => setTimeout(() => r(false), 5e3))])) {
+			this.proc.kill("SIGKILL");
+			await this.exited;
+		}
+		if (this.configDir) {
+			try {
+				(0, node_fs.rmSync)(this.configDir, { recursive: true });
+			} catch {}
+			this.configDir = null;
+		}
+	}
+};
+//#endregion
+exports.NatsServer = NatsServer;
+exports.buildArgs = buildArgs;
+exports.buildConfig = buildConfig;
+exports.resolveBinary = resolve;

package/dist/index.d.cts

@@ -0,0 +1,112 @@
+//#region src/resolve.d.ts
+declare function resolve(): string;
+//#endregion
+//#region src/config.d.ts
+type ConfigBlock = Record<string, unknown>;
+declare function buildConfig(opts: {
+  websocket?: boolean | ConfigBlock;
+  config?: string;
+}): string | null;
+//#endregion
+//#region src/index.d.ts
+interface NatsServerOptions {
+  /** Port to listen on. -1 = random (default), 0 = nats default (4222). */
+  port?: number;
+  /** Host to bind to. Default: 127.0.0.1 */
+  host?: string;
+  /** Server name. Default: auto-generated by NATS */
+  serverName?: string;
+  /** File to store PID */
+  pidFile?: string;
+  /** HTTP monitoring port */
+  httpPort?: number;
+  /** HTTPS monitoring port */
+  httpsPort?: number;
+  /** Client URL to advertise to other servers */
+  clientAdvertise?: string;
+  /** Directory to write ports file */
+  portsFileDir?: string;
+  /** Enable NATS debug output (-D flag) */
+  debug?: boolean;
+  /** Enable NATS protocol trace (-V flag) */
+  trace?: boolean;
+  /** Redirect NATS log output to file */
+  log?: string;
+  /** Timestamp log entries */
+  logtime?: boolean;
+  /** Log to syslog */
+  syslog?: boolean;
+  /** Remote syslog address (e.g. udp://localhost:514) */
+  remoteSyslog?: string;
+  /** Logfile size limit */
+  logSizeLimit?: string;
+  /** Maximum printable length for traced messages */
+  maxTracedMsgLen?: number;
+  /** Enable JetStream */
+  jetstream?: boolean;
+  /** JetStream storage directory */
+  storeDir?: string;
+  /** Username required for connections */
+  user?: string;
+  /** Password required for connections */
+  pass?: string;
+  /** Authorization token required for connections */
+  token?: string;
+  /** Enable TLS */
+  tls?: boolean;
+  /** Server certificate file */
+  tlsCert?: string;
+  /** Private key for server certificate */
+  tlsKey?: string;
+  /** Enable TLS with client certificate verification */
+  tlsVerify?: boolean;
+  /** Client certificate CA for verification */
+  tlsCaCert?: string;
+  /** Routes to solicit and connect */
+  routes?: string[];
+  /** Cluster URL for solicited routes */
+  cluster?: string;
+  /** Cluster name */
+  clusterName?: string;
+  /** Do not advertise known cluster information to clients */
+  noAdvertise?: boolean;
+  /** Cluster URL to advertise to other servers */
+  clusterAdvertise?: string;
+  /** Number of connect retries for implicit routes */
+  connectRetries?: number;
+  /** Cluster URL from which members can solicit routes */
+  clusterListen?: string;
+  /** Profiling HTTP port */
+  profile?: number;
+  /** WebSocket listener. true = embedded defaults (random port, no TLS).
+   *  Object = full websocket config block passed to NATS. */
+  websocket?: boolean | Record<string, unknown>;
+  /** Forward nats-server stderr to process.stderr. Default: false */
+  verbose?: boolean;
+  /** Path to a custom nats.conf file */
+  config?: string;
+  /** Extra CLI arguments passed to nats-server */
+  args?: string[];
+}
+declare function buildArgs(opts: NatsServerOptions, configPath?: string): string[];
+declare class NatsServer {
+  /** Full NATS connection URL (e.g. nats://127.0.0.1:52431) */
+  readonly url: string;
+  /** Assigned port */
+  readonly port: number;
+  /** WebSocket port (undefined if websocket not enabled) */
+  readonly wsPort?: number;
+  /** WebSocket URL (undefined if websocket not enabled) */
+  readonly wsUrl?: string;
+  /** Resolves with the exit code when the process exits (for crash detection) */
+  readonly exited: Promise<number | null>;
+  private proc;
+  private configDir;
+  private constructor();
+  static start(opts?: NatsServerOptions): Promise<NatsServer>;
+  /** Gracefully stop the server (SIGTERM → 5s timeout → SIGKILL) */
+  stop(): Promise<void>;
+}
+//#endregion
+export { NatsServer, NatsServerOptions, buildArgs, buildConfig, resolve as resolveBinary };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/resolve.ts","../src/config.ts","../src/index.ts"],"mappings":";iBAiBgB,OAAA,CAAA;;;KCfX,WAAA,GAAc,MAAA;AAAA,iBAiBH,WAAA,CAAY,IAAA;EAC1B,SAAA,aAAsB,WAAA;EACtB,MAAA;AAAA;;;UCbe,iBAAA;EFSD;EENd,IAAA;;EAEA,IAAA;EFIqB;EEFrB,UAAA;;EAEA,OAAA;EDfG;ECiBH,QAAA;;EAEA,SAAA;EDnBuB;ECqBvB,eAAA;EDJyB;ECMzB,YAAA;EDLiC;ECSjC,KAAA;EDTsB;ECWtB,KAAA;EDZ0B;ECc1B,GAAA;EDXD;ECaC,OAAA;;EAEA,MAAA;EA7Be;EA+Bf,YAAA;;EAEA,YAAA;EA9BA;EAgCA,eAAA;EA5BA;EAgCA,SAAA;EA5BA;EA8BA,QAAA;EA1BA;EA8BA,IAAA;EAxBA;EA0BA,IAAA;EAtBA;EAwBA,KAAA;EApBA;EAwBA,GAAA;EApBA;EAsBA,OAAA;EAhBA;EAkBA,MAAA;EAZA;EAcA,SAAA;EAVA;EAYA,SAAA;EANA;EAUA,MAAA;EANA;EAQA,OAAA;EAFA;EAIA,WAAA;EAAA;EAEA,WAAA;EAEA;EAAA,gBAAA;EAIA;EAFA,cAAA;EAWA;EATA,aAAA;EAaA;EATA,OAAA;EAeA;;EAVA,SAAA,aAAsB,MAAA;EAwDR;EApDd,OAAA;;EAIA,MAAA;EAgD8B;EA9C9B,IAAA;AAAA;AAAA,iBA8Cc,SAAA,CAAU,IAAA,EAAM,iBAAA,EAAmB,UAAA;AAAA,cA2BtC,UAAA;EAAA;EAAA,SAEF,GAAA;;WAEA,IAAA;EA+BgB;EAAA,SA7BhB,MAAA;EA6ByC;EAAA,SA3BzC,KAAA;EAwGY;EAAA,SAtGZ,MAAA,EAAQ,OAAA;EAAA,QAET,IAAA;EAAA,QACA,SAAA;EAAA,QAED,WAAA,CAAA;EAAA,OAoBM,KAAA,CAAM,IAAA,GAAM,iBAAA,GAAyB,OAAA,CAAQ,UAAA;EAzBjD;EAsGH,IAAA,CAAA,GAAQ,OAAA;AAAA"}

package/dist/index.d.mts

@@ -0,0 +1,112 @@
+//#region src/resolve.d.ts
+declare function resolve(): string;
+//#endregion
+//#region src/config.d.ts
+type ConfigBlock = Record<string, unknown>;
+declare function buildConfig(opts: {
+  websocket?: boolean | ConfigBlock;
+  config?: string;
+}): string | null;
+//#endregion
+//#region src/index.d.ts
+interface NatsServerOptions {
+  /** Port to listen on. -1 = random (default), 0 = nats default (4222). */
+  port?: number;
+  /** Host to bind to. Default: 127.0.0.1 */
+  host?: string;
+  /** Server name. Default: auto-generated by NATS */
+  serverName?: string;
+  /** File to store PID */
+  pidFile?: string;
+  /** HTTP monitoring port */
+  httpPort?: number;
+  /** HTTPS monitoring port */
+  httpsPort?: number;
+  /** Client URL to advertise to other servers */
+  clientAdvertise?: string;
+  /** Directory to write ports file */
+  portsFileDir?: string;
+  /** Enable NATS debug output (-D flag) */
+  debug?: boolean;
+  /** Enable NATS protocol trace (-V flag) */
+  trace?: boolean;
+  /** Redirect NATS log output to file */
+  log?: string;
+  /** Timestamp log entries */
+  logtime?: boolean;
+  /** Log to syslog */
+  syslog?: boolean;
+  /** Remote syslog address (e.g. udp://localhost:514) */
+  remoteSyslog?: string;
+  /** Logfile size limit */
+  logSizeLimit?: string;
+  /** Maximum printable length for traced messages */
+  maxTracedMsgLen?: number;
+  /** Enable JetStream */
+  jetstream?: boolean;
+  /** JetStream storage directory */
+  storeDir?: string;
+  /** Username required for connections */
+  user?: string;
+  /** Password required for connections */
+  pass?: string;
+  /** Authorization token required for connections */
+  token?: string;
+  /** Enable TLS */
+  tls?: boolean;
+  /** Server certificate file */
+  tlsCert?: string;
+  /** Private key for server certificate */
+  tlsKey?: string;
+  /** Enable TLS with client certificate verification */
+  tlsVerify?: boolean;
+  /** Client certificate CA for verification */
+  tlsCaCert?: string;
+  /** Routes to solicit and connect */
+  routes?: string[];
+  /** Cluster URL for solicited routes */
+  cluster?: string;
+  /** Cluster name */
+  clusterName?: string;
+  /** Do not advertise known cluster information to clients */
+  noAdvertise?: boolean;
+  /** Cluster URL to advertise to other servers */
+  clusterAdvertise?: string;
+  /** Number of connect retries for implicit routes */
+  connectRetries?: number;
+  /** Cluster URL from which members can solicit routes */
+  clusterListen?: string;
+  /** Profiling HTTP port */
+  profile?: number;
+  /** WebSocket listener. true = embedded defaults (random port, no TLS).
+   *  Object = full websocket config block passed to NATS. */
+  websocket?: boolean | Record<string, unknown>;
+  /** Forward nats-server stderr to process.stderr. Default: false */
+  verbose?: boolean;
+  /** Path to a custom nats.conf file */
+  config?: string;
+  /** Extra CLI arguments passed to nats-server */
+  args?: string[];
+}
+declare function buildArgs(opts: NatsServerOptions, configPath?: string): string[];
+declare class NatsServer {
+  /** Full NATS connection URL (e.g. nats://127.0.0.1:52431) */
+  readonly url: string;
+  /** Assigned port */
+  readonly port: number;
+  /** WebSocket port (undefined if websocket not enabled) */
+  readonly wsPort?: number;
+  /** WebSocket URL (undefined if websocket not enabled) */
+  readonly wsUrl?: string;
+  /** Resolves with the exit code when the process exits (for crash detection) */
+  readonly exited: Promise<number | null>;
+  private proc;
+  private configDir;
+  private constructor();
+  static start(opts?: NatsServerOptions): Promise<NatsServer>;
+  /** Gracefully stop the server (SIGTERM → 5s timeout → SIGKILL) */
+  stop(): Promise<void>;
+}
+//#endregion
+export { NatsServer, NatsServerOptions, buildArgs, buildConfig, resolve as resolveBinary };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/resolve.ts","../src/config.ts","../src/index.ts"],"mappings":";iBAiBgB,OAAA,CAAA;;;KCfX,WAAA,GAAc,MAAA;AAAA,iBAiBH,WAAA,CAAY,IAAA;EAC1B,SAAA,aAAsB,WAAA;EACtB,MAAA;AAAA;;;UCbe,iBAAA;EFSD;EENd,IAAA;;EAEA,IAAA;EFIqB;EEFrB,UAAA;;EAEA,OAAA;EDfG;ECiBH,QAAA;;EAEA,SAAA;EDnBuB;ECqBvB,eAAA;EDJyB;ECMzB,YAAA;EDLiC;ECSjC,KAAA;EDTsB;ECWtB,KAAA;EDZ0B;ECc1B,GAAA;EDXD;ECaC,OAAA;;EAEA,MAAA;EA7Be;EA+Bf,YAAA;;EAEA,YAAA;EA9BA;EAgCA,eAAA;EA5BA;EAgCA,SAAA;EA5BA;EA8BA,QAAA;EA1BA;EA8BA,IAAA;EAxBA;EA0BA,IAAA;EAtBA;EAwBA,KAAA;EApBA;EAwBA,GAAA;EApBA;EAsBA,OAAA;EAhBA;EAkBA,MAAA;EAZA;EAcA,SAAA;EAVA;EAYA,SAAA;EANA;EAUA,MAAA;EANA;EAQA,OAAA;EAFA;EAIA,WAAA;EAAA;EAEA,WAAA;EAEA;EAAA,gBAAA;EAIA;EAFA,cAAA;EAWA;EATA,aAAA;EAaA;EATA,OAAA;EAeA;;EAVA,SAAA,aAAsB,MAAA;EAwDR;EApDd,OAAA;;EAIA,MAAA;EAgD8B;EA9C9B,IAAA;AAAA;AAAA,iBA8Cc,SAAA,CAAU,IAAA,EAAM,iBAAA,EAAmB,UAAA;AAAA,cA2BtC,UAAA;EAAA;EAAA,SAEF,GAAA;;WAEA,IAAA;EA+BgB;EAAA,SA7BhB,MAAA;EA6ByC;EAAA,SA3BzC,KAAA;EAwGY;EAAA,SAtGZ,MAAA,EAAQ,OAAA;EAAA,QAET,IAAA;EAAA,QACA,SAAA;EAAA,QAED,WAAA,CAAA;EAAA,OAoBM,KAAA,CAAM,IAAA,GAAM,iBAAA,GAAyB,OAAA,CAAQ,UAAA;EAzBjD;EAsGH,IAAA,CAAA,GAAQ,OAAA;AAAA"}

package/dist/index.mjs

@@ -0,0 +1,236 @@
+import { createRequire } from "node:module";
+import { spawn } from "node:child_process";
+import { existsSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve as resolve$1 } from "node:path";
+import { arch, platform, tmpdir } from "node:os";
+import { fileURLToPath } from "node:url";
+//#region src/resolve.ts
+const PLATFORM_MAP = {
+	"linux-x64": "@lagz0ne/nats-embedded-linux-x64",
+	"linux-arm64": "@lagz0ne/nats-embedded-linux-arm64",
+	"darwin-x64": "@lagz0ne/nats-embedded-darwin-x64",
+	"darwin-arm64": "@lagz0ne/nats-embedded-darwin-arm64",
+	"win32-x64": "@lagz0ne/nats-embedded-win32-x64",
+	"win32-arm64": "@lagz0ne/nats-embedded-win32-arm64"
+};
+const BINARY_NAME = platform() === "win32" ? "nats-server.exe" : "nats-server";
+function resolve() {
+	if (process.env.NATS_EMBEDDED_BINARY) return process.env.NATS_EMBEDDED_BINARY;
+	const key = `${platform()}-${arch()}`;
+	const pkg = PLATFORM_MAP[key];
+	if (!pkg) throw new Error(`Unsupported platform: ${key}. Supported: ${Object.keys(PLATFORM_MAP).join(", ")}`);
+	try {
+		return createRequire(import.meta.url).resolve(`${pkg}/${BINARY_NAME}`);
+	} catch {
+		const sibling = join(dirname(fileURLToPath(import.meta.url)), "..", "..", key, BINARY_NAME);
+		if (existsSync(sibling)) return sibling;
+		throw new Error(`Cannot find nats-server binary. Install ${pkg} or set NATS_EMBEDDED_BINARY`);
+	}
+}
+//#endregion
+//#region src/parse.ts
+function parsePort(line) {
+	const match = line.match(/Listening for client connections on .+:(\d+)/);
+	return match ? parseInt(match[1], 10) : null;
+}
+function parseWsPort(line) {
+	const match = line.match(/Listening for websocket clients on .+:(\d+)/);
+	return match ? parseInt(match[1], 10) : null;
+}
+//#endregion
+//#region src/config.ts
+function toSnakeCase(str) {
+	return str.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);
+}
+function serializeBlock(name, obj) {
+	return `${name} {\n${Object.entries(obj).map(([k, v]) => {
+		const key = toSnakeCase(k);
+		if (typeof v === "string") return `  ${key}: "${v}"`;
+		return `  ${key}: ${v}`;
+	}).join("\n")}\n}`;
+}
+const WS_DEFAULTS = {
+	port: -1,
+	no_tls: true
+};
+function buildConfig(opts) {
+	if (!opts.websocket) return null;
+	const parts = [serializeBlock("websocket", opts.websocket === true ? { ...WS_DEFAULTS } : {
+		...WS_DEFAULTS,
+		...opts.websocket
+	})];
+	if (opts.config) parts.push(`include '${resolve$1(opts.config)}'`);
+	return parts.join("\n\n") + "\n";
+}
+//#endregion
+//#region src/index.ts
+/**
+* Maps option keys to their nats-server CLI flags.
+* - boolean options: flag is pushed only when true
+* - string/number options: flag + value
+* - string[] options: flag + comma-joined value
+*
+* Keys not in this map are handled separately (host, port, verbose, websocket, config, args).
+*/
+const FLAG_MAP = {
+	serverName: "--server_name",
+	pidFile: "-P",
+	httpPort: "-m",
+	httpsPort: "-ms",
+	clientAdvertise: "--client_advertise",
+	portsFileDir: "--ports_file_dir",
+	debug: "-D",
+	trace: "-V",
+	log: "-l",
+	logtime: "-T",
+	syslog: "-s",
+	remoteSyslog: "-r",
+	logSizeLimit: "--log_size_limit",
+	maxTracedMsgLen: "--max_traced_msg_len",
+	jetstream: "-js",
+	storeDir: "-sd",
+	user: "--user",
+	pass: "--pass",
+	token: "--auth",
+	tls: "--tls",
+	tlsCert: "--tlscert",
+	tlsKey: "--tlskey",
+	tlsVerify: "--tlsverify",
+	tlsCaCert: "--tlscacert",
+	routes: "--routes",
+	cluster: "--cluster",
+	clusterName: "--cluster_name",
+	noAdvertise: "--no_advertise",
+	clusterAdvertise: "--cluster_advertise",
+	connectRetries: "--connect_retries",
+	clusterListen: "--cluster_listen",
+	profile: "--profile"
+};
+function buildArgs(opts, configPath) {
+	const host = opts.host ?? "127.0.0.1";
+	const port = opts.port ?? -1;
+	const args = [
+		"-a",
+		host,
+		"-p",
+		String(port)
+	];
+	for (const [key, flag] of Object.entries(FLAG_MAP)) {
+		const val = opts[key];
+		if (val === void 0 || val === false) continue;
+		if (val === true) args.push(flag);
+		else if (Array.isArray(val)) args.push(flag, val.join(","));
+		else args.push(flag, String(val));
+	}
+	if (configPath) args.push("-c", configPath);
+	else if (opts.config) args.push("-c", opts.config);
+	if (opts.args) args.push(...opts.args);
+	return args;
+}
+var NatsServer = class NatsServer {
+	/** Full NATS connection URL (e.g. nats://127.0.0.1:52431) */
+	url;
+	/** Assigned port */
+	port;
+	/** WebSocket port (undefined if websocket not enabled) */
+	wsPort;
+	/** WebSocket URL (undefined if websocket not enabled) */
+	wsUrl;
+	/** Resolves with the exit code when the process exits (for crash detection) */
+	exited;
+	proc;
+	configDir;
+	constructor(proc, host, port, wsPort, configDir) {
+		this.proc = proc;
+		this.port = port;
+		this.url = `nats://${host}:${port}`;
+		if (wsPort !== void 0) {
+			this.wsPort = wsPort;
+			this.wsUrl = `ws://${host}:${wsPort}`;
+		}
+		this.configDir = configDir;
+		this.exited = new Promise((res) => {
+			proc.on("exit", (code) => res(code));
+		});
+	}
+	static async start(opts = {}) {
+		const bin = resolve();
+		const host = opts.host ?? "127.0.0.1";
+		const needWs = !!opts.websocket;
+		let configDir = null;
+		let configPath;
+		const configContent = buildConfig(opts);
+		if (configContent) {
+			configDir = mkdtempSync(join(tmpdir(), "nats-embedded-"));
+			configPath = join(configDir, "nats.conf");
+			writeFileSync(configPath, configContent);
+		}
+		const proc = spawn(bin, buildArgs(opts, configPath), { stdio: [
+			"ignore",
+			"ignore",
+			"pipe"
+		] });
+		const result = await new Promise((resolve, reject) => {
+			const timeout = setTimeout(() => {
+				proc.kill("SIGKILL");
+				reject(/* @__PURE__ */ new Error("nats-server did not start within 5s"));
+			}, 5e3);
+			proc.on("error", (err) => {
+				clearTimeout(timeout);
+				reject(err);
+			});
+			proc.on("exit", (code) => {
+				clearTimeout(timeout);
+				reject(/* @__PURE__ */ new Error(`nats-server exited with code ${code} before ready`));
+			});
+			let tcpPort = null;
+			let wsPort = null;
+			let resolved = false;
+			let buffer = "";
+			proc.stderr.on("data", (chunk) => {
+				const text = chunk.toString();
+				if (opts.verbose) process.stderr.write(text);
+				if (resolved) return;
+				buffer += text;
+				const lines = buffer.split("\n");
+				buffer = lines.pop();
+				for (const line of lines) {
+					const tcp = parsePort(line);
+					if (tcp !== null) tcpPort = tcp;
+					const ws = parseWsPort(line);
+					if (ws !== null) wsPort = ws;
+					if (tcpPort !== null && (!needWs || wsPort !== null)) {
+						resolved = true;
+						clearTimeout(timeout);
+						proc.removeAllListeners("exit");
+						resolve({
+							tcpPort,
+							wsPort: wsPort ?? void 0
+						});
+						return;
+					}
+				}
+			});
+		});
+		return new NatsServer(proc, host, result.tcpPort, result.wsPort, configDir);
+	}
+	/** Gracefully stop the server (SIGTERM → 5s timeout → SIGKILL) */
+	async stop() {
+		if (this.proc.exitCode !== null) return;
+		this.proc.kill("SIGTERM");
+		if (!await Promise.race([this.exited.then(() => true), new Promise((r) => setTimeout(() => r(false), 5e3))])) {
+			this.proc.kill("SIGKILL");
+			await this.exited;
+		}
+		if (this.configDir) {
+			try {
+				rmSync(this.configDir, { recursive: true });
+			} catch {}
+			this.configDir = null;
+		}
+	}
+};
+//#endregion
+export { NatsServer, buildArgs, buildConfig, resolve as resolveBinary };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["resolvePath"],"sources":["../src/resolve.ts","../src/parse.ts","../src/config.ts","../src/index.ts"],"sourcesContent":["import { platform, arch } from \"node:os\";\nimport { existsSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { join, dirname } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst PLATFORM_MAP: Record<string, string> = {\n  \"linux-x64\": \"@lagz0ne/nats-embedded-linux-x64\",\n  \"linux-arm64\": \"@lagz0ne/nats-embedded-linux-arm64\",\n  \"darwin-x64\": \"@lagz0ne/nats-embedded-darwin-x64\",\n  \"darwin-arm64\": \"@lagz0ne/nats-embedded-darwin-arm64\",\n  \"win32-x64\": \"@lagz0ne/nats-embedded-win32-x64\",\n  \"win32-arm64\": \"@lagz0ne/nats-embedded-win32-arm64\",\n};\n\nconst BINARY_NAME = platform() === \"win32\" ? \"nats-server.exe\" : \"nats-server\";\n\nexport function resolve(): string {\n  if (process.env.NATS_EMBEDDED_BINARY) return process.env.NATS_EMBEDDED_BINARY;\n\n  const key = `${platform()}-${arch()}`;\n  const pkg = PLATFORM_MAP[key];\n  if (!pkg) throw new Error(`Unsupported platform: ${key}. Supported: ${Object.keys(PLATFORM_MAP).join(\", \")}`);\n\n  // Try require.resolve first (works when platform packages are installed via npm)\n  try {\n    const require_ = createRequire(import.meta.url);\n    return require_.resolve(`${pkg}/${BINARY_NAME}`);\n  } catch {\n    // Fallback: sibling package in monorepo layout\n    const __dirname = dirname(fileURLToPath(import.meta.url));\n    const sibling = join(__dirname, \"..\", \"..\", key, BINARY_NAME);\n    if (existsSync(sibling)) return sibling;\n    throw new Error(`Cannot find nats-server binary. Install ${pkg} or set NATS_EMBEDDED_BINARY`);\n  }\n}\n","export function parsePort(line: string): number | null {\n  const match = line.match(/Listening for client connections on .+:(\\d+)/);\n  return match ? parseInt(match[1], 10) : null;\n}\n\nexport function parseWsPort(line: string): number | null {\n  const match = line.match(/Listening for websocket clients on .+:(\\d+)/);\n  return match ? parseInt(match[1], 10) : null;\n}\n","import { resolve as resolvePath } from \"node:path\";\n\ntype ConfigBlock = Record<string, unknown>;\n\nfunction toSnakeCase(str: string): string {\n  return str.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);\n}\n\nfunction serializeBlock(name: string, obj: ConfigBlock): string {\n  const lines = Object.entries(obj).map(([k, v]) => {\n    const key = toSnakeCase(k);\n    if (typeof v === \"string\") return `  ${key}: \"${v}\"`;\n    return `  ${key}: ${v}`;\n  });\n  return `${name} {\\n${lines.join(\"\\n\")}\\n}`;\n}\n\nconst WS_DEFAULTS: ConfigBlock = { port: -1, no_tls: true };\n\nexport function buildConfig(opts: {\n  websocket?: boolean | ConfigBlock;\n  config?: string;\n}): string | null {\n  if (!opts.websocket) return null;\n\n  const ws =\n    opts.websocket === true\n      ? { ...WS_DEFAULTS }\n      : { ...WS_DEFAULTS, ...opts.websocket };\n\n  const parts: string[] = [serializeBlock(\"websocket\", ws)];\n\n  if (opts.config) {\n    parts.push(`include '${resolvePath(opts.config)}'`);\n  }\n\n  return parts.join(\"\\n\\n\") + \"\\n\";\n}\n","import { spawn, type ChildProcess } from \"node:child_process\";\nimport { mkdtempSync, writeFileSync, rmSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { tmpdir } from \"node:os\";\nimport { resolve } from \"./resolve.js\";\nimport { parsePort, parseWsPort } from \"./parse.js\";\nimport { buildConfig } from \"./config.js\";\n\nexport interface NatsServerOptions {\n  // ── Server ──────────────────────────────────────────────────────────\n  /** Port to listen on. -1 = random (default), 0 = nats default (4222). */\n  port?: number;\n  /** Host to bind to. Default: 127.0.0.1 */\n  host?: string;\n  /** Server name. Default: auto-generated by NATS */\n  serverName?: string;\n  /** File to store PID */\n  pidFile?: string;\n  /** HTTP monitoring port */\n  httpPort?: number;\n  /** HTTPS monitoring port */\n  httpsPort?: number;\n  /** Client URL to advertise to other servers */\n  clientAdvertise?: string;\n  /** Directory to write ports file */\n  portsFileDir?: string;\n\n  // ── Logging ─────────────────────────────────────────────────────────\n  /** Enable NATS debug output (-D flag) */\n  debug?: boolean;\n  /** Enable NATS protocol trace (-V flag) */\n  trace?: boolean;\n  /** Redirect NATS log output to file */\n  log?: string;\n  /** Timestamp log entries */\n  logtime?: boolean;\n  /** Log to syslog */\n  syslog?: boolean;\n  /** Remote syslog address (e.g. udp://localhost:514) */\n  remoteSyslog?: string;\n  /** Logfile size limit */\n  logSizeLimit?: string;\n  /** Maximum printable length for traced messages */\n  maxTracedMsgLen?: number;\n\n  // ── JetStream ───────────────────────────────────────────────────────\n  /** Enable JetStream */\n  jetstream?: boolean;\n  /** JetStream storage directory */\n  storeDir?: string;\n\n  // ── Auth ────────────────────────────────────────────────────────────\n  /** Username required for connections */\n  user?: string;\n  /** Password required for connections */\n  pass?: string;\n  /** Authorization token required for connections */\n  token?: string;\n\n  // ── TLS ─────────────────────────────────────────────────────────────\n  /** Enable TLS */\n  tls?: boolean;\n  /** Server certificate file */\n  tlsCert?: string;\n  /** Private key for server certificate */\n  tlsKey?: string;\n  /** Enable TLS with client certificate verification */\n  tlsVerify?: boolean;\n  /** Client certificate CA for verification */\n  tlsCaCert?: string;\n\n  // ── Cluster ─────────────────────────────────────────────────────────\n  /** Routes to solicit and connect */\n  routes?: string[];\n  /** Cluster URL for solicited routes */\n  cluster?: string;\n  /** Cluster name */\n  clusterName?: string;\n  /** Do not advertise known cluster information to clients */\n  noAdvertise?: boolean;\n  /** Cluster URL to advertise to other servers */\n  clusterAdvertise?: string;\n  /** Number of connect retries for implicit routes */\n  connectRetries?: number;\n  /** Cluster URL from which members can solicit routes */\n  clusterListen?: string;\n\n  // ── Profiling ───────────────────────────────────────────────────────\n  /** Profiling HTTP port */\n  profile?: number;\n\n  // ── WebSocket ───────────────────────────────────────────────────────\n  /** WebSocket listener. true = embedded defaults (random port, no TLS).\n   *  Object = full websocket config block passed to NATS. */\n  websocket?: boolean | Record<string, unknown>;\n\n  // ── Wrapper ─────────────────────────────────────────────────────────\n  /** Forward nats-server stderr to process.stderr. Default: false */\n  verbose?: boolean;\n\n  // ── Escape hatches (forward-compat) ─────────────────────────────────\n  /** Path to a custom nats.conf file */\n  config?: string;\n  /** Extra CLI arguments passed to nats-server */\n  args?: string[];\n}\n\n/**\n * Maps option keys to their nats-server CLI flags.\n * - boolean options: flag is pushed only when true\n * - string/number options: flag + value\n * - string[] options: flag + comma-joined value\n *\n * Keys not in this map are handled separately (host, port, verbose, websocket, config, args).\n */\nconst FLAG_MAP: Record<string, string> = {\n  serverName: \"--server_name\",\n  pidFile: \"-P\",\n  httpPort: \"-m\",\n  httpsPort: \"-ms\",\n  clientAdvertise: \"--client_advertise\",\n  portsFileDir: \"--ports_file_dir\",\n  debug: \"-D\",\n  trace: \"-V\",\n  log: \"-l\",\n  logtime: \"-T\",\n  syslog: \"-s\",\n  remoteSyslog: \"-r\",\n  logSizeLimit: \"--log_size_limit\",\n  maxTracedMsgLen: \"--max_traced_msg_len\",\n  jetstream: \"-js\",\n  storeDir: \"-sd\",\n  user: \"--user\",\n  pass: \"--pass\",\n  token: \"--auth\",\n  tls: \"--tls\",\n  tlsCert: \"--tlscert\",\n  tlsKey: \"--tlskey\",\n  tlsVerify: \"--tlsverify\",\n  tlsCaCert: \"--tlscacert\",\n  routes: \"--routes\",\n  cluster: \"--cluster\",\n  clusterName: \"--cluster_name\",\n  noAdvertise: \"--no_advertise\",\n  clusterAdvertise: \"--cluster_advertise\",\n  connectRetries: \"--connect_retries\",\n  clusterListen: \"--cluster_listen\",\n  profile: \"--profile\",\n};\n\nexport function buildArgs(opts: NatsServerOptions, configPath?: string): string[] {\n  const host = opts.host ?? \"127.0.0.1\";\n  const port = opts.port ?? -1;\n  const args = [\"-a\", host, \"-p\", String(port)];\n\n  for (const [key, flag] of Object.entries(FLAG_MAP)) {\n    const val = (opts as Record<string, unknown>)[key];\n    if (val === undefined || val === false) continue;\n    if (val === true) {\n      args.push(flag);\n    } else if (Array.isArray(val)) {\n      args.push(flag, val.join(\",\"));\n    } else {\n      args.push(flag, String(val));\n    }\n  }\n\n  if (configPath) {\n    args.push(\"-c\", configPath);\n  } else if (opts.config) {\n    args.push(\"-c\", opts.config);\n  }\n\n  if (opts.args) args.push(...opts.args);\n  return args;\n}\n\nexport class NatsServer {\n  /** Full NATS connection URL (e.g. nats://127.0.0.1:52431) */\n  readonly url: string;\n  /** Assigned port */\n  readonly port: number;\n  /** WebSocket port (undefined if websocket not enabled) */\n  readonly wsPort?: number;\n  /** WebSocket URL (undefined if websocket not enabled) */\n  readonly wsUrl?: string;\n  /** Resolves with the exit code when the process exits (for crash detection) */\n  readonly exited: Promise<number | null>;\n\n  private proc: ChildProcess;\n  private configDir: string | null;\n\n  private constructor(\n    proc: ChildProcess,\n    host: string,\n    port: number,\n    wsPort: number | undefined,\n    configDir: string | null,\n  ) {\n    this.proc = proc;\n    this.port = port;\n    this.url = `nats://${host}:${port}`;\n    if (wsPort !== undefined) {\n      this.wsPort = wsPort;\n      this.wsUrl = `ws://${host}:${wsPort}`;\n    }\n    this.configDir = configDir;\n    this.exited = new Promise((res) => {\n      proc.on(\"exit\", (code) => res(code));\n    });\n  }\n\n  static async start(opts: NatsServerOptions = {}): Promise<NatsServer> {\n    const bin = resolve();\n    const host = opts.host ?? \"127.0.0.1\";\n    const needWs = !!opts.websocket;\n\n    // Generate config file if needed (websocket requires config block)\n    let configDir: string | null = null;\n    let configPath: string | undefined;\n    const configContent = buildConfig(opts);\n    if (configContent) {\n      configDir = mkdtempSync(join(tmpdir(), \"nats-embedded-\"));\n      configPath = join(configDir, \"nats.conf\");\n      writeFileSync(configPath, configContent);\n    }\n\n    const args = buildArgs(opts, configPath);\n\n    const proc = spawn(bin, args, {\n      stdio: [\"ignore\", \"ignore\", \"pipe\"],\n    });\n\n    const result = await new Promise<{ tcpPort: number; wsPort?: number }>(\n      (resolve, reject) => {\n        const timeout = setTimeout(() => {\n          proc.kill(\"SIGKILL\");\n          reject(new Error(\"nats-server did not start within 5s\"));\n        }, 5000);\n\n        proc.on(\"error\", (err) => {\n          clearTimeout(timeout);\n          reject(err);\n        });\n\n        proc.on(\"exit\", (code) => {\n          clearTimeout(timeout);\n          reject(\n            new Error(`nats-server exited with code ${code} before ready`),\n          );\n        });\n\n        let tcpPort: number | null = null;\n        let wsPort: number | null = null;\n        let resolved = false;\n        let buffer = \"\";\n\n        proc.stderr!.on(\"data\", (chunk: Buffer) => {\n          const text = chunk.toString();\n          if (opts.verbose) process.stderr.write(text);\n          if (resolved) return;\n          buffer += text;\n          const lines = buffer.split(\"\\n\");\n          buffer = lines.pop()!;\n          for (const line of lines) {\n            const tcp = parsePort(line);\n            if (tcp !== null) tcpPort = tcp;\n            const ws = parseWsPort(line);\n            if (ws !== null) wsPort = ws;\n\n            if (tcpPort !== null && (!needWs || wsPort !== null)) {\n              resolved = true;\n              clearTimeout(timeout);\n              proc.removeAllListeners(\"exit\");\n              resolve({\n                tcpPort,\n                wsPort: wsPort ?? undefined,\n              });\n              return;\n            }\n          }\n        });\n      },\n    );\n\n    return new NatsServer(proc, host, result.tcpPort, result.wsPort, configDir);\n  }\n\n  /** Gracefully stop the server (SIGTERM → 5s timeout → SIGKILL) */\n  async stop(): Promise<void> {\n    if (this.proc.exitCode !== null) return;\n    this.proc.kill(\"SIGTERM\");\n    const exited = await Promise.race([\n      this.exited.then(() => true),\n      new Promise<false>((r) => setTimeout(() => r(false), 5000)),\n    ]);\n    if (!exited) {\n      this.proc.kill(\"SIGKILL\");\n      await this.exited;\n    }\n    if (this.configDir) {\n      try {\n        rmSync(this.configDir, { recursive: true });\n      } catch {}\n      this.configDir = null;\n    }\n  }\n}\n\nexport { resolve as resolveBinary } from \"./resolve.js\";\nexport { buildConfig } from \"./config.js\";\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lagz0ne/nats-embedded",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Embedded NATS server for Node.js and Bun — managed child process with random port allocation",
   "type": "module",
   "license": "Apache-2.0",
@@ -16,30 +16,38 @@
   "engines": {
     "node": ">=18"
   },
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
     }
   },
   "files": ["dist", "LICENSE"],
   "scripts": {
-    "build": "tsc",
+    "build": "tsdown",
     "test": "bun test"
   },
   "optionalDependencies": {
-    "@lagz0ne/nats-embedded-linux-x64": "0.2.0",
-    "@lagz0ne/nats-embedded-linux-arm64": "0.2.0",
-    "@lagz0ne/nats-embedded-darwin-x64": "0.2.0",
-    "@lagz0ne/nats-embedded-darwin-arm64": "0.2.0",
-    "@lagz0ne/nats-embedded-win32-x64": "0.2.0",
-    "@lagz0ne/nats-embedded-win32-arm64": "0.2.0"
+    "@lagz0ne/nats-embedded-linux-x64": "0.3.1",
+    "@lagz0ne/nats-embedded-linux-arm64": "0.3.1",
+    "@lagz0ne/nats-embedded-darwin-x64": "0.3.1",
+    "@lagz0ne/nats-embedded-darwin-arm64": "0.3.1",
+    "@lagz0ne/nats-embedded-win32-x64": "0.3.1",
+    "@lagz0ne/nats-embedded-win32-arm64": "0.3.1"
   },
   "devDependencies": {
-    "typescript": "^5.7.0",
     "@types/node": "^22.0.0",
-    "bun-types": "^1.2.0"
+    "bun-types": "^1.2.0",
+    "tsdown": "^0.21.4",
+    "typescript": "^5.7.0"
   }
 }

package/dist/index.d.ts

@@ -1,92 +0,0 @@
-export interface NatsServerOptions {
-    /** Port to listen on. -1 = random (default), 0 = nats default (4222). */
-    port?: number;
-    /** Host to bind to. Default: 127.0.0.1 */
-    host?: string;
-    /** Server name. Default: auto-generated by NATS */
-    serverName?: string;
-    /** File to store PID */
-    pidFile?: string;
-    /** HTTP monitoring port */
-    httpPort?: number;
-    /** HTTPS monitoring port */
-    httpsPort?: number;
-    /** Client URL to advertise to other servers */
-    clientAdvertise?: string;
-    /** Directory to write ports file */
-    portsFileDir?: string;
-    /** Enable NATS debug output (-D flag) */
-    debug?: boolean;
-    /** Enable NATS protocol trace (-V flag) */
-    trace?: boolean;
-    /** Redirect NATS log output to file */
-    log?: string;
-    /** Timestamp log entries */
-    logtime?: boolean;
-    /** Log to syslog */
-    syslog?: boolean;
-    /** Remote syslog address (e.g. udp://localhost:514) */
-    remoteSyslog?: string;
-    /** Logfile size limit */
-    logSizeLimit?: string;
-    /** Maximum printable length for traced messages */
-    maxTracedMsgLen?: number;
-    /** Enable JetStream */
-    jetstream?: boolean;
-    /** JetStream storage directory */
-    storeDir?: string;
-    /** Username required for connections */
-    user?: string;
-    /** Password required for connections */
-    pass?: string;
-    /** Authorization token required for connections */
-    token?: string;
-    /** Enable TLS */
-    tls?: boolean;
-    /** Server certificate file */
-    tlsCert?: string;
-    /** Private key for server certificate */
-    tlsKey?: string;
-    /** Enable TLS with client certificate verification */
-    tlsVerify?: boolean;
-    /** Client certificate CA for verification */
-    tlsCaCert?: string;
-    /** Routes to solicit and connect */
-    routes?: string[];
-    /** Cluster URL for solicited routes */
-    cluster?: string;
-    /** Cluster name */
-    clusterName?: string;
-    /** Do not advertise known cluster information to clients */
-    noAdvertise?: boolean;
-    /** Cluster URL to advertise to other servers */
-    clusterAdvertise?: string;
-    /** Number of connect retries for implicit routes */
-    connectRetries?: number;
-    /** Cluster URL from which members can solicit routes */
-    clusterListen?: string;
-    /** Profiling HTTP port */
-    profile?: number;
-    /** Forward nats-server stderr to process.stderr. Default: false */
-    verbose?: boolean;
-    /** Path to a custom nats.conf file */
-    config?: string;
-    /** Extra CLI arguments passed to nats-server */
-    args?: string[];
-}
-export declare function buildArgs(opts: NatsServerOptions): string[];
-export declare class NatsServer {
-    /** Full NATS connection URL (e.g. nats://127.0.0.1:52431) */
-    readonly url: string;
-    /** Assigned port */
-    readonly port: number;
-    /** Resolves with the exit code when the process exits (for crash detection) */
-    readonly exited: Promise<number | null>;
-    private proc;
-    private constructor();
-    static start(opts?: NatsServerOptions): Promise<NatsServer>;
-    /** Gracefully stop the server (SIGTERM → 5s timeout → SIGKILL) */
-    stop(): Promise<void>;
-}
-export { resolve as resolveBinary } from "./resolve.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,143 +0,0 @@
-import { spawn } from "node:child_process";
-import { resolve } from "./resolve.js";
-import { parsePort } from "./parse.js";
-/**
- * Maps option keys to their nats-server CLI flags.
- * - boolean options: flag is pushed only when true
- * - string/number options: flag + value
- * - string[] options: flag + comma-joined value
- *
- * Keys not in this map are handled separately (host, port, verbose, args).
- */
-const FLAG_MAP = {
-    serverName: "--server_name",
-    pidFile: "-P",
-    httpPort: "-m",
-    httpsPort: "-ms",
-    clientAdvertise: "--client_advertise",
-    portsFileDir: "--ports_file_dir",
-    debug: "-D",
-    trace: "-V",
-    log: "-l",
-    logtime: "-T",
-    syslog: "-s",
-    remoteSyslog: "-r",
-    logSizeLimit: "--log_size_limit",
-    maxTracedMsgLen: "--max_traced_msg_len",
-    jetstream: "-js",
-    storeDir: "-sd",
-    user: "--user",
-    pass: "--pass",
-    token: "--auth",
-    tls: "--tls",
-    tlsCert: "--tlscert",
-    tlsKey: "--tlskey",
-    tlsVerify: "--tlsverify",
-    tlsCaCert: "--tlscacert",
-    routes: "--routes",
-    cluster: "--cluster",
-    clusterName: "--cluster_name",
-    noAdvertise: "--no_advertise",
-    clusterAdvertise: "--cluster_advertise",
-    connectRetries: "--connect_retries",
-    clusterListen: "--cluster_listen",
-    profile: "--profile",
-    config: "-c",
-};
-export function buildArgs(opts) {
-    const host = opts.host ?? "127.0.0.1";
-    const port = opts.port ?? -1;
-    const args = ["-a", host, "-p", String(port)];
-    for (const [key, flag] of Object.entries(FLAG_MAP)) {
-        const val = opts[key];
-        if (val === undefined || val === false)
-            continue;
-        if (val === true) {
-            args.push(flag);
-        }
-        else if (Array.isArray(val)) {
-            args.push(flag, val.join(","));
-        }
-        else {
-            args.push(flag, String(val));
-        }
-    }
-    if (opts.args)
-        args.push(...opts.args);
-    return args;
-}
-export class NatsServer {
-    /** Full NATS connection URL (e.g. nats://127.0.0.1:52431) */
-    url;
-    /** Assigned port */
-    port;
-    /** Resolves with the exit code when the process exits (for crash detection) */
-    exited;
-    proc;
-    constructor(proc, host, port) {
-        this.proc = proc;
-        this.port = port;
-        this.url = `nats://${host}:${port}`;
-        this.exited = new Promise((res) => {
-            proc.on("exit", (code) => res(code));
-        });
-    }
-    static async start(opts = {}) {
-        const bin = resolve();
-        const args = buildArgs(opts);
-        const host = opts.host ?? "127.0.0.1";
-        const proc = spawn(bin, args, {
-            stdio: ["ignore", "ignore", "pipe"],
-        });
-        const assignedPort = await new Promise((resolve, reject) => {
-            const timeout = setTimeout(() => {
-                proc.kill("SIGKILL");
-                reject(new Error("nats-server did not start within 5s"));
-            }, 5000);
-            proc.on("error", (err) => {
-                clearTimeout(timeout);
-                reject(err);
-            });
-            proc.on("exit", (code) => {
-                clearTimeout(timeout);
-                reject(new Error(`nats-server exited with code ${code} before ready`));
-            });
-            let buffer = "";
-            proc.stderr.on("data", (chunk) => {
-                const text = chunk.toString();
-                if (opts.verbose)
-                    process.stderr.write(text);
-                buffer += text;
-                const lines = buffer.split("\n");
-                buffer = lines.pop();
-                for (const line of lines) {
-                    const parsed = parsePort(line);
-                    if (parsed !== null) {
-                        clearTimeout(timeout);
-                        // Stop listening for exit as an error once we have the port
-                        proc.removeAllListeners("exit");
-                        resolve(parsed);
-                        return;
-                    }
-                }
-            });
-        });
-        return new NatsServer(proc, host, assignedPort);
-    }
-    /** Gracefully stop the server (SIGTERM → 5s timeout → SIGKILL) */
-    async stop() {
-        if (this.proc.exitCode !== null)
-            return;
-        this.proc.kill("SIGTERM");
-        const exited = await Promise.race([
-            this.exited.then(() => true),
-            new Promise((r) => setTimeout(() => r(false), 5000)),
-        ]);
-        if (!exited) {
-            this.proc.kill("SIGKILL");
-            await this.exited;
-        }
-    }
-}
-export { resolve as resolveBinary } from "./resolve.js";
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/parse.d.ts

@@ -1,2 +0,0 @@
-export declare function parsePort(line: string): number | null;
-//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGrD"}

package/dist/parse.js

@@ -1,5 +0,0 @@
-export function parsePort(line) {
-    const match = line.match(/Listening for client connections on .+:(\d+)/);
-    return match ? parseInt(match[1], 10) : null;
-}
-//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;IACzE,OAAO,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC"}

package/dist/resolve.d.ts

@@ -1,2 +0,0 @@
-export declare function resolve(): string;
-//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAiBA,wBAAgB,OAAO,IAAI,MAAM,CAkBhC"}

package/dist/resolve.js

@@ -1,36 +0,0 @@
-import { platform, arch } from "node:os";
-import { existsSync } from "node:fs";
-import { createRequire } from "node:module";
-import { join, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-const PLATFORM_MAP = {
-    "linux-x64": "@lagz0ne/nats-embedded-linux-x64",
-    "linux-arm64": "@lagz0ne/nats-embedded-linux-arm64",
-    "darwin-x64": "@lagz0ne/nats-embedded-darwin-x64",
-    "darwin-arm64": "@lagz0ne/nats-embedded-darwin-arm64",
-    "win32-x64": "@lagz0ne/nats-embedded-win32-x64",
-    "win32-arm64": "@lagz0ne/nats-embedded-win32-arm64",
-};
-const BINARY_NAME = platform() === "win32" ? "nats-server.exe" : "nats-server";
-export function resolve() {
-    if (process.env.NATS_EMBEDDED_BINARY)
-        return process.env.NATS_EMBEDDED_BINARY;
-    const key = `${platform()}-${arch()}`;
-    const pkg = PLATFORM_MAP[key];
-    if (!pkg)
-        throw new Error(`Unsupported platform: ${key}. Supported: ${Object.keys(PLATFORM_MAP).join(", ")}`);
-    // Try require.resolve first (works when platform packages are installed via npm)
-    try {
-        const require_ = createRequire(import.meta.url);
-        return require_.resolve(`${pkg}/${BINARY_NAME}`);
-    }
-    catch {
-        // Fallback: sibling package in monorepo layout
-        const __dirname = dirname(fileURLToPath(import.meta.url));
-        const sibling = join(__dirname, "..", "..", key, BINARY_NAME);
-        if (existsSync(sibling))
-            return sibling;
-        throw new Error(`Cannot find nats-server binary. Install ${pkg} or set NATS_EMBEDDED_BINARY`);
-    }
-}
-//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,YAAY,GAA2B;IAC3C,WAAW,EAAE,kCAAkC;IAC/C,aAAa,EAAE,oCAAoC;IACnD,YAAY,EAAE,mCAAmC;IACjD,cAAc,EAAE,qCAAqC;IACrD,WAAW,EAAE,kCAAkC;IAC/C,aAAa,EAAE,oCAAoC;CACpD,CAAC;AAEF,MAAM,WAAW,GAAG,QAAQ,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,aAAa,CAAC;AAE/E,MAAM,UAAU,OAAO;IACrB,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAE9E,MAAM,GAAG,GAAG,GAAG,QAAQ,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;IACtC,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,gBAAgB,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAE9G,iFAAiF;IACjF,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChD,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,GAAG,IAAI,WAAW,EAAE,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,+CAA+C;QAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;QAC9D,IAAI,UAAU,CAAC,OAAO,CAAC;YAAE,OAAO,OAAO,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,2CAA2C,GAAG,8BAA8B,CAAC,CAAC;IAChG,CAAC;AACH,CAAC"}