fastify-hl7 3.3.0 → 4.0.1

package/dist/index.mjs

@@ -0,0 +1,377 @@
+import fp from "fastify-plugin";
+import Server, { Inbound } from "node-hl7-server";
+import Client, { Batch, Connection, FileBatch, HL7_2_1, HL7_2_2, HL7_2_3, HL7_2_3_1, HL7_2_4, HL7_2_5, HL7_2_5_1, HL7_2_6, HL7_2_7, HL7_2_7_1, HL7_2_8, Message, createHL7Date, isBatch } from "node-hl7-client";
+import createError from "@fastify/error";
+import { EventEmitter } from "node:events";
+//#region src/errors.ts
+const errors = {
+	/** Error if there is an setup error of the plugin itself. */
+	FASTIFY_HL7_ERR_SETUP_ERRORS: createError("FASTIFY_HL7_ERR_SETUP_ERRORS", "Setup error: %s"),
+	/** If an invalid usage error was done, this error would pop up. */
+	FASTIFY_HL7_ERR_USAGE: createError("FASTIFY_HL7_ERR_USAGE", "Usage error: %s")
+};
+//#endregion
+//#region src/class/hL7Client.ts
+/** Runtime version -> builder-class lookup backing `createBuilder`. */
+const HL7_BUILDERS = {
+	"2.1": HL7_2_1,
+	"2.2": HL7_2_2,
+	"2.3": HL7_2_3,
+	"2.3.1": HL7_2_3_1,
+	"2.4": HL7_2_4,
+	"2.5": HL7_2_5,
+	"2.5.1": HL7_2_5_1,
+	"2.6": HL7_2_6,
+	"2.7": HL7_2_7,
+	"2.7.1": HL7_2_7_1,
+	"2.8": HL7_2_8
+};
+var HL7Client = class {
+	/** @internal */
+	_clientConnections;
+	constructor() {
+		this._clientConnections = [];
+	}
+	/**
+	* Build a HL7 Batch
+	* @remarks Create a properly formatted HL7 Batch.
+	* @since 1.0.0
+	* @param props
+	*/
+	buildBatch(properties) {
+		return new Batch({ ...properties });
+	}
+	/**
+	* Build Date
+	* @remarks Build a date string based off HL7 Standards
+	* @since 2.1.0
+	* @param date
+	* @param length Options are 8, 12, or 14 (default)
+	*/
+	buildDate(date, length) {
+		return createHL7Date(date, length);
+	}
+	/**
+	* Build a HL7 File Batch
+	* @remarks Create a properly formatted HL7 File Batch.
+	* @since 1.0.0
+	* @param props
+	*/
+	buildFileBatch(properties) {
+		if (properties !== void 0 && (properties.fullFilePath !== void 0 || properties.fileBuffer !== void 0)) throw new errors.FASTIFY_HL7_ERR_USAGE("Use readFile or readFileBuffer method. This is for building.");
+		return new FileBatch({ ...properties });
+	}
+	/**
+	* Build a HL7 Message
+	* @remarks Create a properly formatted HL7 message.
+	* @since 1.0.0
+	* @param props
+	*/
+	buildMessage(properties) {
+		if (properties !== void 0 && properties.text !== void 0) throw new errors.FASTIFY_HL7_ERR_USAGE("Use processMessage method. This is for building.");
+		return new Message({ ...properties });
+	}
+	/**
+	* Close All Connections for this Client
+	* @since 1.0.0
+	*/
+	async closeAll() {
+		for (const outbound of this._clientConnections) outbound.ports.map(async (port) => {
+			await port.connection.close();
+		});
+		return true;
+	}
+	/**
+	* Create a version-pinned HL7 message builder
+	* @remarks Returns the node-hl7-client builder for the given HL7 version, with
+	* per-version field validation (withdrawn fields throw, backward-compatibility
+	* fields warn, segments not in that version are rejected). Chain `build*`
+	* methods and finish with `toMessage()`.
+	* @since 4.0.0
+	* @param version One of the supported HL7 versions ("2.1" - "2.8").
+	* @param properties Optional builder options (date format, separators, hardError).
+	* @example
+	* ```ts
+	* const message = fastify.hl7.createBuilder("2.7")
+	*   .buildMSH({ msh_9_1: "ADT", msh_9_2: "A01", msh_11_1: "P" })
+	*   .buildPID({ pid_3: "MRN12345", pid_5: "DOE^JANE^A" })
+	*   .toMessage();
+	* ```
+	*/
+	createBuilder(version, properties) {
+		const Builder = HL7_BUILDERS[version];
+		return new Builder(properties);
+	}
+	/**
+	*
+	* @param name
+	* @param props
+	*/
+	createClient(name, properties) {
+		if (/[ `!@#$%^&*()+\-=\[\]{};':"\\|,.<>\/?~]/.test(name)) throw new errors.FASTIFY_HL7_ERR_USAGE("name must not contain certain characters: `!@#$%^&*()+\\-=\\[\\]{};':\"\\\\|,.<>\\/?~.");
+		for (const connections of this._clientConnections) if (connections.name === name) throw new errors.FASTIFY_HL7_ERR_USAGE("name must be unique.");
+		const client = new Client(properties);
+		this._clientConnections.push({
+			client,
+			name,
+			ports: []
+		});
+		return client;
+	}
+	/**
+	* Create an HL7 Outbound Connection
+	* @remarks Connect to an HL7 Server/Broker
+	* @since 1.0.0
+	* @param name The name stored within created client connections.
+	* @param props
+	* @param handler
+	*/
+	createConnection(name, properties, handler) {
+		if (/[ `!@#$%^&*()+\-=\[\]{};':"\\|,.<>\/?~]/.test(name)) throw new errors.FASTIFY_HL7_ERR_USAGE("name must not contain certain characters: `!@#$%^&*()+\\-=\\[\\]{};':\"\\\\|,.<>\\/?~.");
+		const getConnection = this._clientConnections.find((client) => client.name === name);
+		if (getConnection !== void 0) {
+			for (const outbound of getConnection.ports) if (outbound.port === properties.port.toString()) throw new errors.FASTIFY_HL7_ERR_USAGE(`port ${properties.port} is already used with this client. Choose a new outgoing port.`);
+			const outbound = new Connection(getConnection.client, properties, handler);
+			getConnection.ports.push({
+				connection: outbound,
+				port: properties.port.toString()
+			});
+			return outbound;
+		}
+		throw new errors.FASTIFY_HL7_ERR_USAGE("No valid client. Improper setup of a outbound connection.");
+	}
+	/**
+	* Get Client by the name
+	* @since 1.0.0
+	* @param name
+	*/
+	getClientByName(name) {
+		const connection = this._clientConnections.find((connection) => connection.name === name);
+		if (connection !== void 0) return connection.client;
+	}
+	/**
+	* Get Connection by Port
+	* @since 1.0.0
+	* @param port
+	*/
+	getClientConnectionByPort(port) {
+		let connection;
+		for (const outbound of this._clientConnections) for (const aPort of outbound.ports) if (aPort.port === port) connection = aPort.connection;
+		return connection;
+	}
+	/**
+	* Process a HL7
+	* @remarks A HL7 message that could either be a Message (MSH) or Batch (BHS)
+	* @since 1.0.0
+	* @param text Raw HL& String
+	*/
+	processHL7(text) {
+		return isBatch(text) ? new Batch({ text }) : new Message({ text });
+	}
+	/**
+	* Read File
+	* @remarks Pass the correct path of the file you want to read.
+	* @since 1.0.0
+	* @param fullFilePath
+	* @returns FileBatch
+	* @example
+	* ```ts
+	* fastify.hl7.readFile( path.join('temp/', 'hl7.readTestBHS.20231208.hl7') )
+	* ```
+	*/
+	readFile(fullFilePath) {
+		return new FileBatch({ fullFilePath });
+	}
+	/**
+	* Read a File Buffer
+	* @remarks Translate an already Buffered HL7 FHS segment to decode it.
+	* @since 1.0.0
+	* @param fileBuffer
+	* @returns FileBatch
+	* @example
+	* ```ts
+	* const fileBuffer = fs.readFileSync(path.join('temp/', 'hl7.readTestBHS.20231208.hl7'))
+	* fastify.hl7.readFileBuffer(fileBuffer)
+	* ```
+	*/
+	readFileBuffer(fileBuffer) {
+		return new FileBatch({ fileBuffer });
+	}
+};
+//#endregion
+//#region src/class/hL7Server.ts
+var HL7Server = class extends EventEmitter {
+	_server;
+	_serverInboundConnections;
+	constructor(server) {
+		super();
+		this._server = server;
+		this._serverInboundConnections = [];
+	}
+	/**
+	* Close Inbound connection.
+	* @since 1.0.0
+	* @param port
+	*/
+	async close(port) {
+		const inbound = this._serverInboundConnections.find((server) => server.port === port);
+		if (inbound !== void 0) return await inbound.server.close();
+		throw new errors.FASTIFY_HL7_ERR_USAGE(`No inbound server listening on port: ${port}`);
+	}
+	/**
+	* Close all Inbound connections.
+	* @since 1.0.0
+	*/
+	async closeAll() {
+		this._serverInboundConnections.map(async (inbound) => {
+			await inbound.server.close();
+		});
+		return true;
+	}
+	/**
+	* Create Inbound connection.
+	* @since 1.0.0
+	* @param name
+	* @param props
+	* @param handler
+	*/
+	createInbound(name, properties, handler) {
+		if (/[ `!@#$%^&*()+\-=\[\]{};':"\\|,.<>\/?~]/.test(name)) throw new errors.FASTIFY_HL7_ERR_USAGE("name must not contain certain characters: `!@#$%^&*()+\\-=\\[\\]{};':\"\\\\|,.<>\\/?~.");
+		const inbound = new Inbound(this._server, properties, handler);
+		this._serverInboundConnections.push({
+			name,
+			port: properties.port.toString(),
+			server: inbound
+		});
+		this.emit("inbound", properties.port.toString());
+		return inbound;
+	}
+	/**
+	* Get Server Inbound Connection by Name
+	* @since 1.0.0
+	* @param name
+	*/
+	getServerByName(name) {
+		const inbound = this._serverInboundConnections.find((inbound) => inbound.name === name);
+		if (inbound !== void 0) return inbound.server;
+	}
+	/**
+	* Get Server Inbound Connection by Port
+	* @since 1.0.0
+	* @param port
+	*/
+	getServerByPort(port) {
+		const inbound = this._serverInboundConnections.find((inbound) => inbound.port === port);
+		if (inbound !== void 0) return inbound.server;
+	}
+};
+//#endregion
+//#region src/validation.ts
+/**
+* @since 1.0.0
+* @param opts
+*/
+const validateOpts = async (options) => {
+	if (options.enableServer === void 0) options.enableServer = true;
+	return options;
+};
+//#endregion
+//#region src/index.ts
+/**
+* @since 1.0.0
+* @param fastify
+* @param _opts
+* @param connection
+*/
+const decorateFastifyInstance = (fastify, _options, connection) => {
+	if (fastify.hl7 !== void 0) throw new errors.FASTIFY_HL7_ERR_SETUP_ERRORS("Already registered.");
+	if (fastify.hl7 === void 0) {
+		fastify.log.trace("[fastify-hl7] Decorate Fastify");
+		fastify.decorate("hl7", connection);
+	}
+};
+const fastifyHL7 = fp(async (fastify, options) => {
+	const generatedOptions = await validateOpts(options);
+	options = {
+		...options,
+		...generatedOptions
+	};
+	const serverInstance = options.enableServer !== void 0 && options.enableServer ? new Server(options.serverOptions) : void 0;
+	let server;
+	if (serverInstance !== void 0) {
+		server = new HL7Server(serverInstance);
+		server.on("inbound", (port) => {
+			fastify.log.info("HL7 Inbound Server Listening on Port %s", port);
+		});
+		fastify.addHook("preClose", async () => {
+			if (server !== void 0) await server.closeAll();
+		});
+	}
+	const client = new HL7Client();
+	fastify.addHook("preClose", async () => {
+		if (client !== void 0) await client.closeAll();
+	});
+	decorateFastifyInstance(fastify, options, {
+		_serverInstance: serverInstance,
+		buildBatch: function(properties) {
+			return client.buildBatch(properties);
+		},
+		buildDate: function(date, length) {
+			return client.buildDate(date, length);
+		},
+		buildFileBatch: function(properties) {
+			return client.buildFileBatch(properties);
+		},
+		buildMessage: function(properties) {
+			return client.buildMessage(properties);
+		},
+		closeServer: async function(port) {
+			if (server !== void 0) return await server.close(port);
+			throw new errors.FASTIFY_HL7_ERR_USAGE("server was not started. re-register plugin with enableServer set to true.");
+		},
+		closeServerAll: async () => {
+			if (server !== void 0) return await server.closeAll();
+			throw new errors.FASTIFY_HL7_ERR_USAGE("server was not started. re-register plugin with enableServer set to true.");
+		},
+		createBuilder: function(version, properties) {
+			return client.createBuilder(version, properties);
+		},
+		createClient: function(name, properties) {
+			return client.createClient(name, properties);
+		},
+		createConnection: function(name, properties, handler) {
+			return client.createConnection(name, properties, handler);
+		},
+		createInbound: function(name, properties, handler) {
+			if (server !== void 0) return server.createInbound(name, properties, handler);
+			throw new errors.FASTIFY_HL7_ERR_USAGE("server was not started. re-register plugin with enableServer set to true.");
+		},
+		getClientByName: function(name) {
+			return client.getClientByName(name);
+		},
+		getClientConnectionByPort: function(port) {
+			return client.getClientConnectionByPort(port);
+		},
+		getServerByName: function(name) {
+			if (server !== void 0) return server.getServerByName(name);
+			throw new errors.FASTIFY_HL7_ERR_USAGE("server was not started. re-register plugin with enableServer set to true.");
+		},
+		getServerByPort: function(port) {
+			if (server !== void 0) return server.getServerByPort(port);
+			throw new errors.FASTIFY_HL7_ERR_USAGE("server was not started. re-register plugin with enableServer set to true.");
+		},
+		processHL7: function(text) {
+			return client.processHL7(text);
+		},
+		readFile: function(fullFilePath) {
+			return client.readFile(fullFilePath);
+		},
+		readFileBuffer: function(fileBuffer) {
+			return client.readFileBuffer(fileBuffer);
+		}
+	});
+});
+//#endregion
+export { fastifyHL7 as default };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["validateOptions"],"sources":["../src/errors.ts","../src/class/hL7Client.ts","../src/class/hL7Server.ts","../src/validation.ts","../src/index.ts"],"sourcesContent":["/*\nMIT License\n\nCopyright (c) 2026 Shane Froebel\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.\n*/\nimport createError from \"@fastify/error\";\n\nexport const errors = {\n  /** Error if there is an setup error of the plugin itself. */\n  FASTIFY_HL7_ERR_SETUP_ERRORS: createError(\n    \"FASTIFY_HL7_ERR_SETUP_ERRORS\",\n    \"Setup error: %s\",\n  ),\n  /** If an invalid usage error was done, this error would pop up. */\n  FASTIFY_HL7_ERR_USAGE: createError(\n    \"FASTIFY_HL7_ERR_USAGE\",\n    \"Usage error: %s\",\n  ),\n};\n","/*\nMIT License\n\nCopyright (c) 2026 Shane Froebel\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.\n*/\nimport Client, {\n  Batch,\n  ClientBuilderFileOptions,\n  ClientBuilderMessageOptions,\n  ClientBuilderOptions,\n  ClientListenerOptions,\n  ClientOptions,\n  Connection,\n  createHL7Date,\n  FileBatch,\n  HL7_2_1,\n  HL7_2_2,\n  HL7_2_3,\n  HL7_2_3_1,\n  HL7_2_4,\n  HL7_2_5,\n  HL7_2_5_1,\n  HL7_2_6,\n  HL7_2_7,\n  HL7_2_7_1,\n  HL7_2_8,\n  HL7Version,\n  isBatch,\n  Message,\n  OutboundHandler,\n} from \"node-hl7-client\";\n\nimport { AClients } from \"../decorate.js\";\nimport { errors } from \"../errors.js\";\n\n/** Accepted HL7 date-length values, derived from node-hl7-client's\n * `createHL7Date` so it stays in sync with the upstream type. */\nexport type DateLength = Parameters<typeof createHL7Date>[1];\n\n/** Maps an `HL7Version` string to the matching node-hl7-client builder class,\n * so `createBuilder(\"2.7\")` returns a fully typed `HL7_2_7`. */\nexport interface HL7VersionBuilders {\n  \"2.1\": HL7_2_1;\n  \"2.2\": HL7_2_2;\n  \"2.3\": HL7_2_3;\n  \"2.3.1\": HL7_2_3_1;\n  \"2.4\": HL7_2_4;\n  \"2.5\": HL7_2_5;\n  \"2.5.1\": HL7_2_5_1;\n  \"2.6\": HL7_2_6;\n  \"2.7\": HL7_2_7;\n  \"2.7.1\": HL7_2_7_1;\n  \"2.8\": HL7_2_8;\n}\n\n/** Runtime version -> builder-class lookup backing `createBuilder`. */\nconst HL7_BUILDERS = {\n  \"2.1\": HL7_2_1,\n  \"2.2\": HL7_2_2,\n  \"2.3\": HL7_2_3,\n  \"2.3.1\": HL7_2_3_1,\n  \"2.4\": HL7_2_4,\n  \"2.5\": HL7_2_5,\n  \"2.5.1\": HL7_2_5_1,\n  \"2.6\": HL7_2_6,\n  \"2.7\": HL7_2_7,\n  \"2.7.1\": HL7_2_7_1,\n  \"2.8\": HL7_2_8,\n} as const;\n\nexport class HL7Client {\n  /** @internal */\n  private readonly _clientConnections: AClients[];\n\n  constructor() {\n    this._clientConnections = [];\n  }\n\n  /**\n   * Build a HL7 Batch\n   * @remarks Create a properly formatted HL7 Batch.\n   * @since 1.0.0\n   * @param props\n   */\n  buildBatch(properties?: ClientBuilderOptions): Batch {\n    return new Batch({ ...properties });\n  }\n\n  /**\n   * Build Date\n   * @remarks Build a date string based off HL7 Standards\n   * @since 2.1.0\n   * @param date\n   * @param length Options are 8, 12, or 14 (default)\n   */\n  buildDate(date: Date, length?: DateLength): string {\n    return createHL7Date(date, length);\n  }\n\n  /**\n   * Build a HL7 File Batch\n   * @remarks Create a properly formatted HL7 File Batch.\n   * @since 1.0.0\n   * @param props\n   */\n  buildFileBatch(properties?: ClientBuilderFileOptions): FileBatch {\n    if (\n      properties !== undefined &&\n      (properties.fullFilePath !== undefined ||\n        properties.fileBuffer !== undefined)\n    ) {\n      throw new errors.FASTIFY_HL7_ERR_USAGE(\n        \"Use readFile or readFileBuffer method. This is for building.\",\n      );\n    }\n    return new FileBatch({ ...properties });\n  }\n\n  /**\n   * Build a HL7 Message\n   * @remarks Create a properly formatted HL7 message.\n   * @since 1.0.0\n   * @param props\n   */\n  buildMessage(properties?: ClientBuilderMessageOptions): Message {\n    if (properties !== undefined && properties.text !== undefined) {\n      throw new errors.FASTIFY_HL7_ERR_USAGE(\n        \"Use processMessage method. This is for building.\",\n      );\n    }\n    return new Message({ ...properties });\n  }\n\n  /**\n   * Close All Connections for this Client\n   * @since 1.0.0\n   */\n  async closeAll(): Promise<boolean> {\n    for (const outbound of this._clientConnections) {\n      outbound.ports.map(async (port) => {\n        await port.connection.close();\n      });\n    }\n    return true;\n  }\n\n  /**\n   * Create a version-pinned HL7 message builder\n   * @remarks Returns the node-hl7-client builder for the given HL7 version, with\n   * per-version field validation (withdrawn fields throw, backward-compatibility\n   * fields warn, segments not in that version are rejected). Chain `build*`\n   * methods and finish with `toMessage()`.\n   * @since 4.0.0\n   * @param version One of the supported HL7 versions (\"2.1\" - \"2.8\").\n   * @param properties Optional builder options (date format, separators, hardError).\n   * @example\n   * ```ts\n   * const message = fastify.hl7.createBuilder(\"2.7\")\n   *   .buildMSH({ msh_9_1: \"ADT\", msh_9_2: \"A01\", msh_11_1: \"P\" })\n   *   .buildPID({ pid_3: \"MRN12345\", pid_5: \"DOE^JANE^A\" })\n   *   .toMessage();\n   * ```\n   */\n  createBuilder<V extends HL7Version>(\n    version: V,\n    properties?: ClientBuilderOptions,\n  ): HL7VersionBuilders[V] {\n    const Builder = HL7_BUILDERS[version] as new (\n      properties?: ClientBuilderOptions,\n    ) => HL7VersionBuilders[V];\n    return new Builder(properties);\n  }\n\n  /**\n   *\n   * @param name\n   * @param props\n   */\n  createClient(name: string, properties: ClientOptions): Client {\n    const nameFormat = /[ `!@#$%^&*()+\\-=\\[\\]{};':\"\\\\|,.<>\\/?~]/;\n    if (nameFormat.test(name)) {\n      throw new errors.FASTIFY_HL7_ERR_USAGE(\n        \"name must not contain certain characters: `!@#$%^&*()+\\\\-=\\\\[\\\\]{};':\\\"\\\\\\\\|,.<>\\\\/?~.\",\n      );\n    }\n\n    // make sure that this does not exist already...\n    for (const connections of this._clientConnections) {\n      if (connections.name === name) {\n        throw new errors.FASTIFY_HL7_ERR_USAGE(\"name must be unique.\");\n      }\n      // nto in the Client class yet\n      // if (client.getHost() === props.host) {\n      //   throw new errors.FASTIFY_HL7_ERR_USAGE(`host is already a pointer. Name is: ${connections.name}`)\n      // }\n    }\n\n    // new client\n    const client = new Client(properties);\n\n    // add it to the collection\n    this._clientConnections.push({\n      client,\n      name,\n      ports: [],\n    });\n\n    return client;\n  }\n\n  /**\n   * Create an HL7 Outbound Connection\n   * @remarks Connect to an HL7 Server/Broker\n   * @since 1.0.0\n   * @param name The name stored within created client connections.\n   * @param props\n   * @param handler\n   */\n  createConnection(\n    name: string,\n    properties: ClientListenerOptions,\n    handler: OutboundHandler,\n  ): Connection {\n    const nameFormat = /[ `!@#$%^&*()+\\-=\\[\\]{};':\"\\\\|,.<>\\/?~]/;\n    if (nameFormat.test(name)) {\n      throw new errors.FASTIFY_HL7_ERR_USAGE(\n        \"name must not contain certain characters: `!@#$%^&*()+\\\\-=\\\\[\\\\]{};':\\\"\\\\\\\\|,.<>\\\\/?~.\",\n      );\n    }\n\n    const getConnection = this._clientConnections.find(\n      (client) => client.name === name,\n    );\n\n    if (getConnection !== undefined) {\n      // make sure port is not used all ready\n      for (const outbound of getConnection.ports) {\n        if (outbound.port === properties.port.toString()) {\n          throw new errors.FASTIFY_HL7_ERR_USAGE(\n            `port ${properties.port} is already used with this client. Choose a new outgoing port.`,\n          );\n        }\n      }\n\n      // create outbound port to the server in getConnection.client\n      const outbound = new Connection(\n        getConnection.client,\n        properties,\n        handler,\n      );\n\n      // add it to the array of known ports. need to know this, so we can get it later if needed.\n      getConnection.ports.push({\n        connection: outbound,\n        port: properties.port.toString(),\n      });\n\n      // return it right away. the user might do something with it.\n      return outbound;\n    }\n\n    throw new errors.FASTIFY_HL7_ERR_USAGE(\n      \"No valid client. Improper setup of a outbound connection.\",\n    );\n  }\n\n  /**\n   * Get Client by the name\n   * @since 1.0.0\n   * @param name\n   */\n  getClientByName(name: string): Client | undefined {\n    const connection = this._clientConnections.find(\n      (connection) => connection.name === name,\n    );\n    if (connection !== undefined) {\n      return connection.client;\n    }\n    return undefined;\n  }\n\n  /**\n   * Get Connection by Port\n   * @since 1.0.0\n   * @param port\n   */\n  getClientConnectionByPort(port: string): Connection | undefined {\n    let connection: Connection | undefined;\n    for (const outbound of this._clientConnections) {\n      for (const aPort of outbound.ports) {\n        if (aPort.port === port) {\n          connection = aPort.connection;\n        }\n      }\n    }\n    return connection;\n  }\n\n  /**\n   * Process a HL7\n   * @remarks A HL7 message that could either be a Message (MSH) or Batch (BHS)\n   * @since 1.0.0\n   * @param text Raw HL& String\n   */\n  processHL7(text: string): Batch | Message {\n    return isBatch(text) ? new Batch({ text }) : new Message({ text });\n  }\n\n  /**\n   * Read File\n   * @remarks Pass the correct path of the file you want to read.\n   * @since 1.0.0\n   * @param fullFilePath\n   * @returns FileBatch\n   * @example\n   * ```ts\n   * fastify.hl7.readFile( path.join('temp/', 'hl7.readTestBHS.20231208.hl7') )\n   * ```\n   */\n  readFile(fullFilePath: string): FileBatch {\n    return new FileBatch({ fullFilePath });\n  }\n\n  /**\n   * Read a File Buffer\n   * @remarks Translate an already Buffered HL7 FHS segment to decode it.\n   * @since 1.0.0\n   * @param fileBuffer\n   * @returns FileBatch\n   * @example\n   * ```ts\n   * const fileBuffer = fs.readFileSync(path.join('temp/', 'hl7.readTestBHS.20231208.hl7'))\n   * fastify.hl7.readFileBuffer(fileBuffer)\n   * ```\n   */\n  readFileBuffer(fileBuffer: Buffer): FileBatch {\n    return new FileBatch({ fileBuffer });\n  }\n}\n","/*\nMIT License\n\nCopyright (c) 2026 Shane Froebel\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.\n*/\nimport Server, {\n  Inbound,\n  InboundHandler,\n  ListenerOptions,\n} from \"node-hl7-server\";\nimport { EventEmitter } from \"node:events\";\n\nimport { AServers } from \"../decorate.js\";\nimport { errors } from \"../errors.js\";\n\nexport class HL7Server extends EventEmitter {\n  private readonly _server: Server;\n  private readonly _serverInboundConnections: AServers[];\n\n  constructor(server: Server) {\n    super();\n    this._server = server;\n    this._serverInboundConnections = [];\n  }\n\n  /**\n   * Close Inbound connection.\n   * @since 1.0.0\n   * @param port\n   */\n  async close(port: string): Promise<boolean> {\n    const inbound = this._serverInboundConnections.find(\n      (server) => server.port === port,\n    );\n    if (inbound !== undefined) {\n      return await inbound.server.close(); // close the server for all inbound connections\n    }\n    throw new errors.FASTIFY_HL7_ERR_USAGE(\n      `No inbound server listening on port: ${port}`,\n    );\n  }\n\n  /**\n   * Close all Inbound connections.\n   * @since 1.0.0\n   */\n  async closeAll(): Promise<boolean> {\n    this._serverInboundConnections.map(async (inbound) => {\n      await inbound.server.close();\n    });\n    return true;\n  }\n\n  /**\n   * Create Inbound connection.\n   * @since 1.0.0\n   * @param name\n   * @param props\n   * @param handler\n   */\n  createInbound(\n    name: string,\n    properties: ListenerOptions,\n    handler: InboundHandler,\n  ): Inbound {\n    const nameFormat = /[ `!@#$%^&*()+\\-=\\[\\]{};':\"\\\\|,.<>\\/?~]/;\n    if (nameFormat.test(name)) {\n      throw new errors.FASTIFY_HL7_ERR_USAGE(\n        \"name must not contain certain characters: `!@#$%^&*()+\\\\-=\\\\[\\\\]{};':\\\"\\\\\\\\|,.<>\\\\/?~.\",\n      );\n    }\n\n    const inbound = new Inbound(this._server, properties, handler);\n\n    this._serverInboundConnections.push({\n      name,\n      port: properties.port.toString(),\n      server: inbound,\n    });\n\n    this.emit(\"inbound\", properties.port.toString());\n\n    return inbound;\n  }\n\n  /**\n   * Get Server Inbound Connection by Name\n   * @since 1.0.0\n   * @param name\n   */\n  getServerByName(name: string): Inbound | undefined {\n    const inbound = this._serverInboundConnections.find(\n      (inbound) => inbound.name === name,\n    );\n    if (inbound !== undefined) {\n      return inbound.server;\n    }\n    return undefined;\n  }\n\n  /**\n   * Get Server Inbound Connection by Port\n   * @since 1.0.0\n   * @param port\n   */\n  getServerByPort(port: string): Inbound | undefined {\n    const inbound = this._serverInboundConnections.find(\n      (inbound) => inbound.port === port,\n    );\n    if (inbound !== undefined) {\n      return inbound.server;\n    }\n    return undefined;\n  }\n}\n","/*\nMIT License\n\nCopyright (c) 2026 Shane Froebel\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.\n*/\nimport { FastifyHL7Options } from \"./decorate.js\";\n\n/**\n * @since 1.0.0\n * @param opts\n */\nexport const validateOpts = async (\n  options: FastifyHL7Options,\n): Promise<FastifyHL7Options> => {\n  // Mandatory, Defaulted\n  if (options.enableServer === undefined) {\n    options.enableServer = true;\n  }\n\n  return options;\n};\n","/*\nMIT License\n\nCopyright (c) 2026 Shane Froebel\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.\n*/\nimport { FastifyInstance, HL7 } from \"fastify\";\nimport fp from \"fastify-plugin\";\nimport Client, {\n  Batch,\n  ClientBuilderFileOptions,\n  ClientBuilderMessageOptions,\n  ClientBuilderOptions,\n  Connection,\n  FileBatch,\n  HL7Version,\n  Message,\n} from \"node-hl7-client\";\nimport Server, {\n  Inbound,\n  InboundHandler,\n  ListenerOptions,\n} from \"node-hl7-server\";\n\nimport type { FastifyHL7Options } from \"./decorate.js\";\n\nimport {\n  type DateLength,\n  HL7Client,\n  type HL7VersionBuilders,\n} from \"./class/hL7Client.js\";\nimport { HL7Server } from \"./class/hL7Server.js\";\nimport { errors } from \"./errors.js\";\nimport { validateOpts as validateOptions } from \"./validation.js\";\nexport { type FastifyHL7Options } from \"./decorate.js\";\n\n/**\n * @since 1.0.0\n * @param fastify\n * @param _opts\n * @param connection\n */\nconst decorateFastifyInstance = (\n  fastify: FastifyInstance,\n  _options: FastifyHL7Options,\n  connection: HL7,\n): void => {\n  if (fastify.hl7 !== undefined) {\n    throw new errors.FASTIFY_HL7_ERR_SETUP_ERRORS(\"Already registered.\");\n  }\n\n  if (fastify.hl7 === undefined) {\n    fastify.log.trace(\"[fastify-hl7] Decorate Fastify\");\n    fastify.decorate(\"hl7\", connection);\n  }\n};\n\nconst fastifyHL7 = fp<FastifyHL7Options>(async (fastify, options) => {\n  const generatedOptions = await validateOptions(options);\n  options = { ...options, ...generatedOptions };\n\n  // Create server.\n  // Since there can only be one server per IP address\n  // (i.e., the host this is running on.) There can only be more than one.\n  // A server can host many HL7 Inbound connections via different ports, this is fine.\n  // Clients are different as an app could talk to different servers, on many ports.\n  // So we need to do something different.\n  const serverInstance =\n    options.enableServer !== undefined && options.enableServer\n      ? new Server(options.serverOptions)\n      : undefined;\n\n  // Server Functions\n  let server: HL7Server | undefined;\n  if (serverInstance !== undefined) {\n    // Server Functions\n    server = new HL7Server(serverInstance);\n\n    server.on(\"inbound\", (port: string) => {\n      fastify.log.info(\"HL7 Inbound Server Listening on Port %s\", port);\n    });\n\n    // before we close fastify, make sure all server instances are closed\n    fastify.addHook(\"preClose\", async () => {\n      if (server !== undefined) {\n        await server.closeAll();\n      }\n    });\n  }\n\n  // Client Functions\n  const client = new HL7Client();\n\n  // run these before fastify closes\n  fastify.addHook(\"preClose\", async () => {\n    if (client !== undefined) {\n      await client.closeAll();\n    }\n  });\n\n  decorateFastifyInstance(fastify, options, {\n    _serverInstance: serverInstance,\n    buildBatch: function (properties: ClientBuilderOptions | undefined): Batch {\n      return client.buildBatch(properties);\n    },\n    buildDate: function (date: Date, length?: DateLength): string {\n      return client.buildDate(date, length);\n    },\n    buildFileBatch: function (\n      properties: ClientBuilderFileOptions | undefined,\n    ): FileBatch {\n      return client.buildFileBatch(properties);\n    },\n    buildMessage: function (\n      properties: ClientBuilderMessageOptions | undefined,\n    ): Message {\n      return client.buildMessage(properties);\n    },\n    closeServer: async function (port: string): Promise<boolean> {\n      if (server !== undefined) {\n        return await server.close(port);\n      }\n      throw new errors.FASTIFY_HL7_ERR_USAGE(\n        \"server was not started. re-register plugin with enableServer set to true.\",\n      );\n    },\n    closeServerAll: async (): Promise<boolean> => {\n      if (server !== undefined) {\n        return await server.closeAll();\n      }\n      throw new errors.FASTIFY_HL7_ERR_USAGE(\n        \"server was not started. re-register plugin with enableServer set to true.\",\n      );\n    },\n    createBuilder: function <V extends HL7Version>(\n      version: V,\n      properties?: ClientBuilderOptions,\n    ): HL7VersionBuilders[V] {\n      return client.createBuilder(version, properties);\n    },\n    createClient: function (name, properties): Client {\n      return client.createClient(name, properties);\n    },\n    createConnection: function (name, properties, handler) {\n      return client.createConnection(name, properties, handler);\n    },\n    createInbound: function (\n      name: string,\n      properties: ListenerOptions,\n      handler: InboundHandler,\n    ): Inbound {\n      if (server !== undefined) {\n        return server.createInbound(name, properties, handler);\n      }\n      throw new errors.FASTIFY_HL7_ERR_USAGE(\n        \"server was not started. re-register plugin with enableServer set to true.\",\n      );\n    },\n    getClientByName: function (name: string): Client | undefined {\n      return client.getClientByName(name);\n    },\n    getClientConnectionByPort: function (port: string): Connection | undefined {\n      return client.getClientConnectionByPort(port);\n    },\n    getServerByName: function (name: string): Inbound | undefined {\n      if (server !== undefined) {\n        return server.getServerByName(name);\n      }\n      throw new errors.FASTIFY_HL7_ERR_USAGE(\n        \"server was not started. re-register plugin with enableServer set to true.\",\n      );\n    },\n    getServerByPort: function (port: string): Inbound | undefined {\n      if (server !== undefined) {\n        return server.getServerByPort(port);\n      }\n      throw new errors.FASTIFY_HL7_ERR_USAGE(\n        \"server was not started. re-register plugin with enableServer set to true.\",\n      );\n    },\n    processHL7: function (text: string): Batch | Message {\n      return client.processHL7(text);\n    },\n    readFile: function (fullFilePath: string): FileBatch {\n      return client.readFile(fullFilePath);\n    },\n    readFileBuffer: function (fileBuffer: Buffer): FileBatch {\n      return client.readFileBuffer(fileBuffer);\n    },\n  });\n});\n\nexport default fastifyHL7;\n\nexport * from \"./types.js\";\n"],"mappings":"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"}

package/{lib/esm → dist}/types.d.ts

@@ -1,58 +1,70 @@
+import Client, { Batch, ClientBuilderFileOptions, ClientBuilderMessageOptions, ClientBuilderOptions, ClientListenerOptions, ClientOptions, Connection, FileBatch, HL7Version, Message, OutboundHandler } from "node-hl7-client";
 import Server, { Inbound, InboundHandler, ListenerOptions } from "node-hl7-server";
-import Client, { Batch, ClientBuilderFileOptions, ClientBuilderMessageOptions, ClientBuilderOptions, ClientListenerOptions, ClientOptions, Connection, FileBatch, Message, OutboundHandler } from "node-hl7-client";
+import { DateLength, HL7VersionBuilders } from "./class/hL7Client.js";
 declare module "fastify" {
+    interface FastifyInstance {
+        /** Main Decorator for Fastify
+         * @remarks hl7 is the decorator that everything hangs off.
+         * @since 1.0.0 **/
+        hl7: HL7;
+    }
     interface HL7 {
         /** Server Instance
          * @since 1.0.0 **/
         _serverInstance?: Server;
         /** Build HL7 Batch
          * @since 1.0.0 */
-        buildBatch: (props?: ClientBuilderOptions) => Batch;
+        buildBatch: (properties?: ClientBuilderOptions) => Batch;
         /** Build Date
          * @remarks Build a date string based off HL7 Standards
          * @param date
          * @param length Options are 8, 12, or 14 (default)
          * @since 2.1.0
          */
-        buildDate: (date: Date, length?: string) => string;
+        buildDate: (date: Date, length?: DateLength) => string;
         /** Build HL7 File Batch
          * @since 1.0.0 */
-        buildFileBatch: (props?: ClientBuilderFileOptions) => FileBatch;
+        buildFileBatch: (properties?: ClientBuilderFileOptions) => FileBatch;
         /** Build HL7 Message
          * @since 1.0.0 */
-        buildMessage: (props?: ClientBuilderMessageOptions) => Message;
+        buildMessage: (properties?: ClientBuilderMessageOptions) => Message;
         /** Close a incoming HL7 port.
          * @since 1.0.0 */
         closeServer: (port: string) => Promise<boolean>;
         /** Close all incoming HL7 ports.
          * @since 1.0.0 */
         closeServerAll: () => Promise<boolean>;
+        /** Create a version-pinned HL7 message builder.
+         * @remarks Returns the node-hl7-client builder for the given version with
+         * per-version field validation. Chain `build*` and finish with `toMessage()`.
+         * @since 4.0.0 */
+        createBuilder: <V extends HL7Version>(version: V, properties?: ClientBuilderOptions) => HL7VersionBuilders[V];
         /** Create Client
          * @remarks Connecting to a remote server/broker that accepts connections.
          * @since 1.0.0 */
-        createClient: (name: string, props: ClientOptions) => Client;
-        /** Create an incoming port connection on the server.
-         * @since 1.0.0 */
-        createInbound: (name: string, props: ListenerOptions, handler: InboundHandler) => Inbound;
+        createClient: (name: string, properties: ClientOptions) => Client;
         /** Create Outgoing Client Port
          * @remarks This is on the established client that we are already a part off.
          * @since 1.0.0 */
-        createConnection: (name: string, props: ClientListenerOptions, handler: OutboundHandler) => Connection;
+        createConnection: (name: string, properties: ClientListenerOptions, handler: OutboundHandler) => Connection;
+        /** Create an incoming port connection on the server.
+         * @since 1.0.0 */
+        createInbound: (name: string, properties: ListenerOptions, handler: InboundHandler) => Inbound;
         /** Get Client (Outbound) connection by name.
          * @since 1.0.0 */
         getClientByName: (name: string) => Client | undefined;
         /** Get Client Connection (Outbound) connection by port.
          * @since 1.0.0 */
         getClientConnectionByPort: (port: string) => Connection | undefined;
-        /** Get Server (Inbound) connection by port.
-         * @since 1.0.0 */
-        getServerByPort: (port: string) => Inbound | undefined;
         /** Get Server (Inbound) connection by name.
          * @since 1.0.0 */
         getServerByName: (name: string) => Inbound | undefined;
+        /** Get Server (Inbound) connection by port.
+         * @since 1.0.0 */
+        getServerByPort: (port: string) => Inbound | undefined;
         /** Process an HL7 string.
          * @since 1.0.0  */
-        processHL7: (text: string) => Message | Batch;
+        processHL7: (text: string) => Batch | Message;
         /** Read a file from a path.
          * @since 1.0.0 */
         readFile: (fullFilePath: string) => FileBatch;
@@ -60,10 +72,4 @@ declare module "fastify" {
          * @since 1.0.0 */
         readFileBuffer: (fileBuffer: Buffer) => FileBatch;
     }
-    interface FastifyInstance {
-        /** Main Decorator for Fastify
-         * @remarks hl7 is the decorator that everything hangs off.
-         * @since 1.0.0 **/
-        hl7: HL7;
-    }
 }

package/dist/validation.d.ts

@@ -0,0 +1,6 @@
+import { FastifyHL7Options } from "./decorate.js";
+/**
+ * @since 1.0.0
+ * @param opts
+ */
+export declare const validateOpts: (options: FastifyHL7Options) => Promise<FastifyHL7Options>;