secs4js 0.1.0

package/lib/gem/Gem.js

@@ -0,0 +1,137 @@
+import { Secs2ItemAscii } from "../core/secs2item/Secs2ItemAscii.js";
+import { Secs2ItemBinary } from "../core/secs2item/Secs2ItemBinary.js";
+import { Secs2ItemList } from "../core/secs2item/Secs2ItemList.js";
+import { A, B, L } from "../helper/Secs2ItemHelper.js";
+import { Clock, ClockType } from "./Clock.js";
+
+//#region src/gem/Gem.ts
+let CommAck = /* @__PURE__ */ function(CommAck$1) {
+	CommAck$1[CommAck$1["OK"] = 0] = "OK";
+	CommAck$1[CommAck$1["DENIED"] = 1] = "DENIED";
+	return CommAck$1;
+}({});
+let OflAck = /* @__PURE__ */ function(OflAck$1) {
+	OflAck$1[OflAck$1["OK"] = 0] = "OK";
+	return OflAck$1;
+}({});
+let OnlAck = /* @__PURE__ */ function(OnlAck$1) {
+	OnlAck$1[OnlAck$1["OK"] = 0] = "OK";
+	OnlAck$1[OnlAck$1["REFUSE"] = 1] = "REFUSE";
+	OnlAck$1[OnlAck$1["ALREADY_ONLINE"] = 2] = "ALREADY_ONLINE";
+	return OnlAck$1;
+}({});
+let TiAck = /* @__PURE__ */ function(TiAck$1) {
+	TiAck$1[TiAck$1["OK"] = 0] = "OK";
+	TiAck$1[TiAck$1["NOT_DONE"] = 1] = "NOT_DONE";
+	return TiAck$1;
+}({});
+var Gem = class Gem {
+	static DEFAULT_MDLN = "      ";
+	static DEFAULT_SOFTREV = "      ";
+	static DEFAULT_CLOCK_TYPE = ClockType.A16;
+	mdln = Gem.DEFAULT_MDLN;
+	softrev = Gem.DEFAULT_SOFTREV;
+	clockType = Gem.DEFAULT_CLOCK_TYPE;
+	constructor(comm) {
+		this.comm = comm;
+	}
+	async s1f2(primaryMsg) {
+		await this.comm.reply(primaryMsg, 1, 2, L());
+	}
+	async s1f13() {
+		let body;
+		if (this.comm.isEquip) body = L(A(this.mdln), A(this.softrev));
+		else body = L();
+		const reply = await this.comm.send(1, 13, true, body);
+		if (reply && reply.body instanceof Secs2ItemList) {
+			const list = reply.body;
+			if (list.value.length > 0 && list.value[0] instanceof Secs2ItemBinary) return list.value[0].value[0];
+		}
+		throw new Error("S1F14 invalid response or not COMMACK");
+	}
+	async s1f14(primaryMsg, commAck) {
+		let body;
+		if (this.comm.isEquip) body = L(B(Buffer.from([commAck])), L(A(this.mdln), A(this.softrev)));
+		else body = L(B(Buffer.from([commAck])), L());
+		await this.comm.reply(primaryMsg, 1, 14, body);
+	}
+	async s1f15() {
+		const reply = await this.comm.send(1, 15, true);
+		if (reply && reply.body instanceof Secs2ItemBinary) return reply.body.value[0];
+		throw new Error("S1F16 invalid response or not OFLACK");
+	}
+	async s1f16(primaryMsg) {
+		await this.comm.reply(primaryMsg, 1, 16, B(Buffer.from([OflAck.OK])));
+	}
+	async s1f17() {
+		const reply = await this.comm.send(1, 17, true);
+		if (reply && reply.body instanceof Secs2ItemBinary) return reply.body.value[0];
+		throw new Error("S1F18 invalid response or not ONLACK");
+	}
+	async s1f18(primaryMsg, onlAck) {
+		await this.comm.reply(primaryMsg, 1, 18, B(Buffer.from([onlAck])));
+	}
+	async s2f17() {
+		const reply = await this.comm.send(2, 17, true);
+		if (reply?.body instanceof Secs2ItemAscii) return Clock.fromAscii(reply.body);
+		throw new Error("S2F18 invalid response or not time");
+	}
+	async s2f18(primaryMsg, clock = Clock.now()) {
+		const body = this.clockType === ClockType.A12 ? clock.toA12() : clock.toA16();
+		await this.comm.reply(primaryMsg, 2, 18, body);
+	}
+	async s2f18Now(primaryMsg) {
+		return this.s2f18(primaryMsg, Clock.now());
+	}
+	async s2f31(clock) {
+		const body = this.clockType === ClockType.A12 ? clock.toA12() : clock.toA16();
+		const reply = await this.comm.send(2, 31, true, body);
+		if (reply && reply.body instanceof Secs2ItemBinary) return reply.body.value[0];
+		throw new Error("S2F32 invalid response or not TIACK");
+	}
+	async s2f31Now() {
+		return this.s2f31(Clock.now());
+	}
+	async s2f32(primaryMsg, tiAck) {
+		await this.comm.reply(primaryMsg, 2, 32, B(Buffer.from([tiAck])));
+	}
+	async s9f1(refMsg) {
+		await this.s9fy(refMsg, 1);
+	}
+	async s9f3(refMsg) {
+		await this.s9fy(refMsg, 3);
+	}
+	async s9f5(refMsg) {
+		await this.s9fy(refMsg, 5);
+	}
+	async s9f7(refMsg) {
+		await this.s9fy(refMsg, 7);
+	}
+	async s9f9(refMsg) {
+		await this.s9fy(refMsg, 9);
+	}
+	async s9f11(refMsg) {
+		await this.s9fy(refMsg, 11);
+	}
+	async s9fy(refMsg, func) {
+		const header = this.getHeader10Bytes(refMsg);
+		await this.comm.send(9, func, false, B(header));
+	}
+	getHeader10Bytes(msg) {
+		const buffer = Buffer.alloc(10);
+		buffer.writeUInt16BE(msg.deviceId & 32767, 0);
+		let streamByte = msg.stream & 127;
+		if (msg.wBit) streamByte |= 128;
+		buffer.writeUInt8(streamByte, 2);
+		buffer.writeUInt8(msg.func, 3);
+		buffer.writeUInt8(0, 4);
+		buffer.writeUInt8(0, 5);
+		if (typeof msg.systemBytes === "number") buffer.writeUInt32BE(msg.systemBytes, 6);
+		else msg.systemBytes.copy(buffer, 6, 0, 4);
+		return buffer;
+	}
+};
+
+//#endregion
+export { CommAck, Gem, OflAck, OnlAck, TiAck };
+//# sourceMappingURL=Gem.js.map

package/lib/gem/Gem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Gem.js","names":["comm: AbstractSecsCommunicator","body: Secs2ItemList"],"sources":["../../src/gem/Gem.ts"],"sourcesContent":["import { AbstractSecsCommunicator } from \"../core/AbstractSecsCommunicator.js\";\nimport { SecsMessage } from \"../core/AbstractSecsMessage.js\";\nimport { Secs2ItemAscii } from \"../core/secs2item/Secs2ItemAscii.js\";\nimport { Secs2ItemBinary } from \"../core/secs2item/Secs2ItemBinary.js\";\nimport { Secs2ItemList } from \"../core/secs2item/Secs2ItemList.js\";\nimport { A, B, L } from \"../helper/Secs2ItemHelper.js\";\nimport { Clock, ClockType } from \"./Clock.js\";\n\nexport enum CommAck {\n\tOK = 0x0,\n\tDENIED = 0x1,\n}\n\nexport enum OflAck {\n\tOK = 0x0,\n}\n\nexport enum OnlAck {\n\tOK = 0x0,\n\tREFUSE = 0x1,\n\tALREADY_ONLINE = 0x2,\n}\n\nexport enum TiAck {\n\tOK = 0x0,\n\tNOT_DONE = 0x1,\n}\n\nexport class Gem {\n\tprivate static readonly DEFAULT_MDLN = \"      \";\n\tprivate static readonly DEFAULT_SOFTREV = \"      \";\n\tprivate static readonly DEFAULT_CLOCK_TYPE = ClockType.A16;\n\n\tpublic mdln: string = Gem.DEFAULT_MDLN;\n\tpublic softrev: string = Gem.DEFAULT_SOFTREV;\n\tpublic clockType: ClockType = Gem.DEFAULT_CLOCK_TYPE;\n\n\tconstructor(public comm: AbstractSecsCommunicator) {}\n\n\t// S1F2 - Are You There?\n\tasync s1f2(primaryMsg: SecsMessage): Promise<void> {\n\t\tawait this.comm.reply(primaryMsg, 1, 2, L());\n\t}\n\n\t// S1F13 - Establish Communications Request\n\tasync s1f13(): Promise<number> {\n\t\tlet body: Secs2ItemList;\n\t\tif (this.comm.isEquip) {\n\t\t\tbody = L(A(this.mdln), A(this.softrev));\n\t\t} else {\n\t\t\tbody = L();\n\t\t}\n\n\t\tconst reply = await this.comm.send(1, 13, true, body);\n\t\tif (reply && reply.body instanceof Secs2ItemList) {\n\t\t\tconst list = reply.body;\n\t\t\tif (list.value.length > 0 && list.value[0] instanceof Secs2ItemBinary) {\n\t\t\t\tconst bin = list.value[0];\n\t\t\t\treturn bin.value[0];\n\t\t\t}\n\t\t}\n\t\tthrow new Error(\"S1F14 invalid response or not COMMACK\");\n\t}\n\n\t// S1F14 - Establish Communications Acknowledge\n\tasync s1f14(primaryMsg: SecsMessage, commAck: CommAck): Promise<void> {\n\t\tlet body: Secs2ItemList;\n\t\tif (this.comm.isEquip) {\n\t\t\tbody = L(B(Buffer.from([commAck])), L(A(this.mdln), A(this.softrev)));\n\t\t} else {\n\t\t\tbody = L(B(Buffer.from([commAck])), L());\n\t\t}\n\t\tawait this.comm.reply(primaryMsg, 1, 14, body);\n\t}\n\n\t// S1F15 - Request OFF-LINE\n\tasync s1f15(): Promise<number> {\n\t\tconst reply = await this.comm.send(1, 15, true);\n\t\tif (reply && reply.body instanceof Secs2ItemBinary) {\n\t\t\treturn reply.body.value[0];\n\t\t}\n\t\tthrow new Error(\"S1F16 invalid response or not OFLACK\");\n\t}\n\n\t// S1F16 - OFF-LINE Acknowledge\n\tasync s1f16(primaryMsg: SecsMessage): Promise<void> {\n\t\tawait this.comm.reply(primaryMsg, 1, 16, B(Buffer.from([OflAck.OK])));\n\t}\n\n\t// S1F17 - Request ON-LINE\n\tasync s1f17(): Promise<number> {\n\t\tconst reply = await this.comm.send(1, 17, true);\n\t\tif (reply && reply.body instanceof Secs2ItemBinary) {\n\t\t\treturn reply.body.value[0];\n\t\t}\n\t\tthrow new Error(\"S1F18 invalid response or not ONLACK\");\n\t}\n\n\t// S1F18 - ON-LINE Acknowledge\n\tasync s1f18(primaryMsg: SecsMessage, onlAck: OnlAck): Promise<void> {\n\t\tawait this.comm.reply(primaryMsg, 1, 18, B(Buffer.from([onlAck])));\n\t}\n\n\t// S2F17 - Date and Time Request\n\tasync s2f17(): Promise<Clock> {\n\t\tconst reply = await this.comm.send(2, 17, true);\n\t\tif (reply?.body instanceof Secs2ItemAscii) {\n\t\t\treturn Clock.fromAscii(reply.body);\n\t\t}\n\t\tthrow new Error(\"S2F18 invalid response or not time\");\n\t}\n\n\t// S2F18 - Date and Time Data\n\tasync s2f18(\n\t\tprimaryMsg: SecsMessage,\n\t\tclock: Clock = Clock.now(),\n\t): Promise<void> {\n\t\tconst body =\n\t\t\tthis.clockType === ClockType.A12 ? clock.toA12() : clock.toA16();\n\t\tawait this.comm.reply(primaryMsg, 2, 18, body);\n\t}\n\n\tasync s2f18Now(primaryMsg: SecsMessage): Promise<void> {\n\t\treturn this.s2f18(primaryMsg, Clock.now());\n\t}\n\n\t// S2F31 - Date and Time Set Request\n\tasync s2f31(clock: Clock): Promise<number> {\n\t\tconst body =\n\t\t\tthis.clockType === ClockType.A12 ? clock.toA12() : clock.toA16();\n\t\tconst reply = await this.comm.send(2, 31, true, body);\n\t\tif (reply && reply.body instanceof Secs2ItemBinary) {\n\t\t\treturn reply.body.value[0];\n\t\t}\n\t\tthrow new Error(\"S2F32 invalid response or not TIACK\");\n\t}\n\n\tasync s2f31Now(): Promise<number> {\n\t\treturn this.s2f31(Clock.now());\n\t}\n\n\t// S2F32 - Date and Time Set Acknowledge\n\tasync s2f32(primaryMsg: SecsMessage, tiAck: TiAck): Promise<void> {\n\t\tawait this.comm.reply(primaryMsg, 2, 32, B(Buffer.from([tiAck])));\n\t}\n\n\t// S9Fx Helpers\n\tasync s9f1(refMsg: SecsMessage): Promise<void> {\n\t\tawait this.s9fy(refMsg, 1);\n\t}\n\tasync s9f3(refMsg: SecsMessage): Promise<void> {\n\t\tawait this.s9fy(refMsg, 3);\n\t}\n\tasync s9f5(refMsg: SecsMessage): Promise<void> {\n\t\tawait this.s9fy(refMsg, 5);\n\t}\n\tasync s9f7(refMsg: SecsMessage): Promise<void> {\n\t\tawait this.s9fy(refMsg, 7);\n\t}\n\tasync s9f9(refMsg: SecsMessage): Promise<void> {\n\t\tawait this.s9fy(refMsg, 9);\n\t}\n\tasync s9f11(refMsg: SecsMessage): Promise<void> {\n\t\tawait this.s9fy(refMsg, 11);\n\t}\n\n\tprivate async s9fy(refMsg: SecsMessage, func: number): Promise<void> {\n\t\tconst header = this.getHeader10Bytes(refMsg);\n\t\tawait this.comm.send(9, func, false, B(header));\n\t}\n\n\tprivate getHeader10Bytes(msg: SecsMessage): Buffer {\n\t\tconst buffer = Buffer.alloc(10);\n\t\t// Session ID (Device ID)\n\t\tbuffer.writeUInt16BE(msg.deviceId & 0x7fff, 0);\n\n\t\t// Stream + W-bit\n\t\tlet streamByte = msg.stream & 0x7f;\n\t\tif (msg.wBit) {\n\t\t\tstreamByte |= 0x80;\n\t\t}\n\t\tbuffer.writeUInt8(streamByte, 2);\n\n\t\t// Function\n\t\tbuffer.writeUInt8(msg.func, 3);\n\n\t\t// P-Type, S-Type (Assuming 0 for now)\n\t\tbuffer.writeUInt8(0, 4);\n\t\tbuffer.writeUInt8(0, 5);\n\n\t\t// System Bytes\n\t\tif (typeof msg.systemBytes === \"number\") {\n\t\t\tbuffer.writeUInt32BE(msg.systemBytes, 6);\n\t\t} else {\n\t\t\t// Assuming Buffer\n\t\t\tconst sysBuf = msg.systemBytes as Buffer;\n\t\t\tsysBuf.copy(buffer, 6, 0, 4);\n\t\t}\n\n\t\treturn buffer;\n\t}\n}\n"],"mappings":"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"}

package/lib/helper/Secs2ItemHelper.d.ts

@@ -0,0 +1,96 @@
+import { AbstractSecs2Item } from "../core/secs2item/AbstractSecs2Item.js";
+import { Secs2ItemAscii } from "../core/secs2item/Secs2ItemAscii.js";
+import { Secs2ItemBinary } from "../core/secs2item/Secs2ItemBinary.js";
+import { Secs2ItemBoolean } from "../core/secs2item/Secs2ItemBoolean.js";
+import { Secs2ItemNumeric } from "../core/secs2item/Secs2ItemNumeric.js";
+import { Secs2ItemList } from "../core/secs2item/Secs2ItemList.js";
+
+//#region src/helper/Secs2ItemHelper.d.ts
+
+/**
+ * @description Creates a SECS-II list item.
+ * @param items The items in the list.
+ * @returns The SECS-II list item.
+ */
+declare function L(...items: AbstractSecs2Item[]): Secs2ItemList;
+/**
+ * @description Creates a SECS-II ASCII item.
+ * @param value The value of the item.
+ * @returns The SECS-II ASCII item.
+ */
+declare function A(value: string): Secs2ItemAscii;
+/**
+ * @description Creates a SECS-II boolean item.
+ * @param value The value of the item.
+ * @returns The SECS-II boolean item.
+ */
+declare function BOOLEAN(value: string): Secs2ItemBoolean;
+/**
+ * @description Creates a SECS-II binary item.
+ * @param value The value of the item.
+ * @returns The SECS-II binary item.
+ */
+declare function B(value: string | Buffer): Secs2ItemBinary;
+/**
+ * @description Creates a SECS-II unsigned 8-bit integer item.
+ * @param value The value of the item.
+ * @returns The SECS-II unsigned 8-bit integer item.
+ */
+declare function U1(...value: number[]): Secs2ItemNumeric;
+/**
+ * @description Creates a SECS-II unsigned 16-bit integer item.
+ * @param value The value of the item.
+ * @returns The SECS-II unsigned 16-bit integer item.
+ */
+declare function U2(...value: number[]): Secs2ItemNumeric;
+/**
+ * @description Creates a SECS-II unsigned 32-bit integer item.
+ * @param value The value of the item.
+ * @returns The SECS-II unsigned 32-bit integer item.
+ */
+declare function U4(...value: number[]): Secs2ItemNumeric;
+/**
+ * @description Creates a SECS-II unsigned 64-bit integer item.
+ * @param value The value of the item.
+ * @returns The SECS-II unsigned 64-bit integer item.
+ */
+declare function U8(...value: number[] | bigint[]): Secs2ItemNumeric;
+/**
+ * @description Creates a SECS-II signed 8-bit integer item.
+ * @param value The value of the item.
+ * @returns The SECS-II signed 8-bit integer item.
+ */
+declare function I1(...value: number[]): Secs2ItemNumeric;
+/**
+ * @description Creates a SECS-II signed 16-bit integer item.
+ * @param value The value of the item.
+ * @returns The SECS-II signed 16-bit integer item.
+ */
+declare function I2(...value: number[]): Secs2ItemNumeric;
+/**
+ * @description Creates a SECS-II signed 32-bit integer item.
+ * @param value The value of the item.
+ * @returns The SECS-II signed 32-bit integer item.
+ */
+declare function I4(...value: number[]): Secs2ItemNumeric;
+/**
+ * @description Creates a SECS-II signed 64-bit integer item.
+ * @param value The value of the item.
+ * @returns The SECS-II signed 64-bit integer item.
+ */
+declare function I8(...value: number[] | bigint[]): Secs2ItemNumeric;
+/**
+ * @description Creates a SECS-II float 32-bit number item.
+ * @param value The value of the item.
+ * @returns The SECS-II float 32-bit number item.
+ */
+declare function F4(...value: number[]): Secs2ItemNumeric;
+/**
+ * @description Creates a SECS-II float 64-bit number item.
+ * @param value The value of the item.
+ * @returns The SECS-II float 64-bit number item.
+ */
+declare function F8(...value: number[]): Secs2ItemNumeric;
+//#endregion
+export { A, B, BOOLEAN, F4, F8, I1, I2, I4, I8, L, U1, U2, U4, U8 };
+//# sourceMappingURL=Secs2ItemHelper.d.ts.map

package/lib/helper/Secs2ItemHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Secs2ItemHelper.d.ts","names":[],"sources":["../../src/helper/Secs2ItemHelper.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;AAaA;AASA;AASA;AAqBgB,iBAvCA,CAAA,CAuCkB,GAAS,KAAA,EAvCf,iBAuC8B,EAAA,CAAA,EAvCR,aAuCQ;AAsB1D;AAYA;AAYA;AAYA;AAYA;AASgB,iBA7GA,CAAA,CA6GwB,KAAA,EAAA,MAAgB,CAAA,EA7GtB,cA6GsB;AASxD;AASA;AASA;AAYA;;iBA3IgB,OAAA,iBAAwB;;;;;;iBAqBxB,CAAA,iBAAkB,SAAS;;;;;;iBAsB3B,EAAA,sBAAwB;;;;;;iBAYxB,EAAA,sBAAwB;;;;;;iBAYxB,EAAA,sBAAwB;;;;;;iBAYxB,EAAA,iCAAmC;;;;;;iBAYnC,EAAA,sBAAwB;;;;;;iBASxB,EAAA,sBAAwB;;;;;;iBASxB,EAAA,sBAAwB;;;;;;iBASxB,EAAA,iCAAmC;;;;;;iBASnC,EAAA,sBAAwB;;;;;;iBAYxB,EAAA,sBAAwB"}

package/lib/helper/Secs2ItemHelper.js

@@ -0,0 +1,135 @@
+import { Secs2ItemFactory } from "../core/secs2item/Secs2ItemFactory.js";
+
+//#region src/helper/Secs2ItemHelper.ts
+/**
+* @description Creates a SECS-II list item.
+* @param items The items in the list.
+* @returns The SECS-II list item.
+*/
+function L(...items) {
+	return Secs2ItemFactory.createListItem(...items);
+}
+/**
+* @description Creates a SECS-II ASCII item.
+* @param value The value of the item.
+* @returns The SECS-II ASCII item.
+*/
+function A(value) {
+	return Secs2ItemFactory.createAsciiItem(value);
+}
+/**
+* @description Creates a SECS-II boolean item.
+* @param value The value of the item.
+* @returns The SECS-II boolean item.
+*/
+function BOOLEAN(value) {
+	const booleanValues = [];
+	value.split("").map((v) => {
+		if (v !== "TRUE" && v !== "FALSE") throw new Error("BOOLEAN value must be TRUE or FALSE");
+		if (v === "TRUE") booleanValues.push(true);
+		else booleanValues.push(false);
+	});
+	return Secs2ItemFactory.createBooleanItem(...booleanValues);
+}
+/**
+* @description Creates a SECS-II binary item.
+* @param value The value of the item.
+* @returns The SECS-II binary item.
+*/
+function B(value) {
+	if (typeof value === "string") {
+		const stringToBytes = (s) => s.split(/\s+/).map((v) => v.trim().startsWith("0x") ? parseInt(v, 16) : parseInt(v, 10));
+		const binaryValues = stringToBytes(value);
+		return Secs2ItemFactory.createBinaryItem(Buffer.from(binaryValues));
+	}
+	return Secs2ItemFactory.createBinaryItem(value);
+}
+/**
+* @description Creates a SECS-II unsigned 8-bit integer item.
+* @param value The value of the item.
+* @returns The SECS-II unsigned 8-bit integer item.
+*/
+function U1(...value) {
+	if (value.some((v) => v < 0)) throw new Error("U1 value must be unsigned 8-bit integer");
+	return Secs2ItemFactory.createU1Item(...value);
+}
+/**
+* @description Creates a SECS-II unsigned 16-bit integer item.
+* @param value The value of the item.
+* @returns The SECS-II unsigned 16-bit integer item.
+*/
+function U2(...value) {
+	if (value.some((v) => v < 0)) throw new Error("U2 value must be unsigned 16-bit integer");
+	return Secs2ItemFactory.createU2Item(...value);
+}
+/**
+* @description Creates a SECS-II unsigned 32-bit integer item.
+* @param value The value of the item.
+* @returns The SECS-II unsigned 32-bit integer item.
+*/
+function U4(...value) {
+	if (value.some((v) => v < 0)) throw new Error("U4 value must be unsigned 32-bit integer");
+	return Secs2ItemFactory.createU4Item(...value);
+}
+/**
+* @description Creates a SECS-II unsigned 64-bit integer item.
+* @param value The value of the item.
+* @returns The SECS-II unsigned 64-bit integer item.
+*/
+function U8(...value) {
+	if (value.some((v) => v < 0)) throw new Error("U8 value must be unsigned 64-bit integer");
+	return Secs2ItemFactory.createU8Item(...value);
+}
+/**
+* @description Creates a SECS-II signed 8-bit integer item.
+* @param value The value of the item.
+* @returns The SECS-II signed 8-bit integer item.
+*/
+function I1(...value) {
+	return Secs2ItemFactory.createI1Item(...value);
+}
+/**
+* @description Creates a SECS-II signed 16-bit integer item.
+* @param value The value of the item.
+* @returns The SECS-II signed 16-bit integer item.
+*/
+function I2(...value) {
+	return Secs2ItemFactory.createI2Item(...value);
+}
+/**
+* @description Creates a SECS-II signed 32-bit integer item.
+* @param value The value of the item.
+* @returns The SECS-II signed 32-bit integer item.
+*/
+function I4(...value) {
+	return Secs2ItemFactory.createI4Item(...value);
+}
+/**
+* @description Creates a SECS-II signed 64-bit integer item.
+* @param value The value of the item.
+* @returns The SECS-II signed 64-bit integer item.
+*/
+function I8(...value) {
+	return Secs2ItemFactory.createI8Item(...value);
+}
+/**
+* @description Creates a SECS-II float 32-bit number item.
+* @param value The value of the item.
+* @returns The SECS-II float 32-bit number item.
+*/
+function F4(...value) {
+	if (value.some((v) => v % 1 !== 0)) throw new Error("F4 value must be float 32-bit number");
+	return Secs2ItemFactory.createF4Item(...value);
+}
+/**
+* @description Creates a SECS-II float 64-bit number item.
+* @param value The value of the item.
+* @returns The SECS-II float 64-bit number item.
+*/
+function F8(...value) {
+	return Secs2ItemFactory.createF8Item(...value);
+}
+
+//#endregion
+export { A, B, BOOLEAN, F4, F8, I1, I2, I4, I8, L, U1, U2, U4, U8 };
+//# sourceMappingURL=Secs2ItemHelper.js.map

package/lib/helper/Secs2ItemHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Secs2ItemHelper.js","names":["booleanValues: boolean[]","binaryValues: number[]"],"sources":["../../src/helper/Secs2ItemHelper.ts"],"sourcesContent":["import { AbstractSecs2Item } from \"../core/secs2item/AbstractSecs2Item.js\";\nimport { Secs2ItemAscii } from \"../core/secs2item/Secs2ItemAscii.js\";\nimport { Secs2ItemBinary } from \"../core/secs2item/Secs2ItemBinary.js\";\nimport { Secs2ItemBoolean } from \"../core/secs2item/Secs2ItemBoolean.js\";\nimport { Secs2ItemFactory } from \"../core/secs2item/Secs2ItemFactory.js\";\nimport { Secs2ItemList } from \"../core/secs2item/Secs2ItemList.js\";\nimport { Secs2ItemNumeric } from \"../core/secs2item/Secs2ItemNumeric.js\";\n\n/**\n * @description Creates a SECS-II list item.\n * @param items The items in the list.\n * @returns The SECS-II list item.\n */\nexport function L(...items: AbstractSecs2Item[]): Secs2ItemList {\n\treturn Secs2ItemFactory.createListItem(...items);\n}\n\n/**\n * @description Creates a SECS-II ASCII item.\n * @param value The value of the item.\n * @returns The SECS-II ASCII item.\n */\nexport function A(value: string): Secs2ItemAscii {\n\treturn Secs2ItemFactory.createAsciiItem(value);\n}\n\n/**\n * @description Creates a SECS-II boolean item.\n * @param value The value of the item.\n * @returns The SECS-II boolean item.\n */\nexport function BOOLEAN(value: string): Secs2ItemBoolean {\n\tconst booleanValues: boolean[] = [];\n\tconst values = value.split(\"\");\n\tvalues.map((v) => {\n\t\tif (v !== \"TRUE\" && v !== \"FALSE\") {\n\t\t\tthrow new Error(\"BOOLEAN value must be TRUE or FALSE\");\n\t\t}\n\t\tif (v === \"TRUE\") {\n\t\t\tbooleanValues.push(true);\n\t\t} else {\n\t\t\tbooleanValues.push(false);\n\t\t}\n\t});\n\treturn Secs2ItemFactory.createBooleanItem(...booleanValues);\n}\n\n/**\n * @description Creates a SECS-II binary item.\n * @param value The value of the item.\n * @returns The SECS-II binary item.\n */\nexport function B(value: string | Buffer): Secs2ItemBinary {\n\tconst valueType = typeof value;\n\tif (valueType === \"string\") {\n\t\tconst stringToBytes = (s: string) =>\n\t\t\ts\n\t\t\t\t.split(/\\s+/)\n\t\t\t\t.map((v) =>\n\t\t\t\t\tv.trim().startsWith(\"0x\") ? parseInt(v, 16) : parseInt(v, 10),\n\t\t\t\t);\n\n\t\tconst binaryValues: number[] = stringToBytes(value as string);\n\t\treturn Secs2ItemFactory.createBinaryItem(Buffer.from(binaryValues));\n\t}\n\n\treturn Secs2ItemFactory.createBinaryItem(value as Buffer);\n}\n\n/**\n * @description Creates a SECS-II unsigned 8-bit integer item.\n * @param value The value of the item.\n * @returns The SECS-II unsigned 8-bit integer item.\n */\nexport function U1(...value: number[]): Secs2ItemNumeric {\n\tif (value.some((v) => v < 0)) {\n\t\tthrow new Error(\"U1 value must be unsigned 8-bit integer\");\n\t}\n\treturn Secs2ItemFactory.createU1Item(...value);\n}\n\n/**\n * @description Creates a SECS-II unsigned 16-bit integer item.\n * @param value The value of the item.\n * @returns The SECS-II unsigned 16-bit integer item.\n */\nexport function U2(...value: number[]): Secs2ItemNumeric {\n\tif (value.some((v) => v < 0)) {\n\t\tthrow new Error(\"U2 value must be unsigned 16-bit integer\");\n\t}\n\treturn Secs2ItemFactory.createU2Item(...value);\n}\n\n/**\n * @description Creates a SECS-II unsigned 32-bit integer item.\n * @param value The value of the item.\n * @returns The SECS-II unsigned 32-bit integer item.\n */\nexport function U4(...value: number[]): Secs2ItemNumeric {\n\tif (value.some((v) => v < 0)) {\n\t\tthrow new Error(\"U4 value must be unsigned 32-bit integer\");\n\t}\n\treturn Secs2ItemFactory.createU4Item(...value);\n}\n\n/**\n * @description Creates a SECS-II unsigned 64-bit integer item.\n * @param value The value of the item.\n * @returns The SECS-II unsigned 64-bit integer item.\n */\nexport function U8(...value: number[] | bigint[]): Secs2ItemNumeric {\n\tif (value.some((v) => v < 0)) {\n\t\tthrow new Error(\"U8 value must be unsigned 64-bit integer\");\n\t}\n\treturn Secs2ItemFactory.createU8Item(...value);\n}\n\n/**\n * @description Creates a SECS-II signed 8-bit integer item.\n * @param value The value of the item.\n * @returns The SECS-II signed 8-bit integer item.\n */\nexport function I1(...value: number[]): Secs2ItemNumeric {\n\treturn Secs2ItemFactory.createI1Item(...value);\n}\n\n/**\n * @description Creates a SECS-II signed 16-bit integer item.\n * @param value The value of the item.\n * @returns The SECS-II signed 16-bit integer item.\n */\nexport function I2(...value: number[]): Secs2ItemNumeric {\n\treturn Secs2ItemFactory.createI2Item(...value);\n}\n\n/**\n * @description Creates a SECS-II signed 32-bit integer item.\n * @param value The value of the item.\n * @returns The SECS-II signed 32-bit integer item.\n */\nexport function I4(...value: number[]): Secs2ItemNumeric {\n\treturn Secs2ItemFactory.createI4Item(...value);\n}\n\n/**\n * @description Creates a SECS-II signed 64-bit integer item.\n * @param value The value of the item.\n * @returns The SECS-II signed 64-bit integer item.\n */\nexport function I8(...value: number[] | bigint[]): Secs2ItemNumeric {\n\treturn Secs2ItemFactory.createI8Item(...value);\n}\n\n/**\n * @description Creates a SECS-II float 32-bit number item.\n * @param value The value of the item.\n * @returns The SECS-II float 32-bit number item.\n */\nexport function F4(...value: number[]): Secs2ItemNumeric {\n\tif (value.some((v) => v % 1 !== 0)) {\n\t\tthrow new Error(\"F4 value must be float 32-bit number\");\n\t}\n\treturn Secs2ItemFactory.createF4Item(...value);\n}\n\n/**\n * @description Creates a SECS-II float 64-bit number item.\n * @param value The value of the item.\n * @returns The SECS-II float 64-bit number item.\n */\nexport function F8(...value: number[]): Secs2ItemNumeric {\n\treturn Secs2ItemFactory.createF8Item(...value);\n}\n"],"mappings":";;;;;;;;AAaA,SAAgB,EAAE,GAAG,OAA2C;AAC/D,QAAO,iBAAiB,eAAe,GAAG,MAAM;;;;;;;AAQjD,SAAgB,EAAE,OAA+B;AAChD,QAAO,iBAAiB,gBAAgB,MAAM;;;;;;;AAQ/C,SAAgB,QAAQ,OAAiC;CACxD,MAAMA,gBAA2B,EAAE;AAEnC,CADe,MAAM,MAAM,GAAG,CACvB,KAAK,MAAM;AACjB,MAAI,MAAM,UAAU,MAAM,QACzB,OAAM,IAAI,MAAM,sCAAsC;AAEvD,MAAI,MAAM,OACT,eAAc,KAAK,KAAK;MAExB,eAAc,KAAK,MAAM;GAEzB;AACF,QAAO,iBAAiB,kBAAkB,GAAG,cAAc;;;;;;;AAQ5D,SAAgB,EAAE,OAAyC;AAE1D,KADkB,OAAO,UACP,UAAU;EAC3B,MAAM,iBAAiB,MACtB,EACE,MAAM,MAAM,CACZ,KAAK,MACL,EAAE,MAAM,CAAC,WAAW,KAAK,GAAG,SAAS,GAAG,GAAG,GAAG,SAAS,GAAG,GAAG,CAC7D;EAEH,MAAMC,eAAyB,cAAc,MAAgB;AAC7D,SAAO,iBAAiB,iBAAiB,OAAO,KAAK,aAAa,CAAC;;AAGpE,QAAO,iBAAiB,iBAAiB,MAAgB;;;;;;;AAQ1D,SAAgB,GAAG,GAAG,OAAmC;AACxD,KAAI,MAAM,MAAM,MAAM,IAAI,EAAE,CAC3B,OAAM,IAAI,MAAM,0CAA0C;AAE3D,QAAO,iBAAiB,aAAa,GAAG,MAAM;;;;;;;AAQ/C,SAAgB,GAAG,GAAG,OAAmC;AACxD,KAAI,MAAM,MAAM,MAAM,IAAI,EAAE,CAC3B,OAAM,IAAI,MAAM,2CAA2C;AAE5D,QAAO,iBAAiB,aAAa,GAAG,MAAM;;;;;;;AAQ/C,SAAgB,GAAG,GAAG,OAAmC;AACxD,KAAI,MAAM,MAAM,MAAM,IAAI,EAAE,CAC3B,OAAM,IAAI,MAAM,2CAA2C;AAE5D,QAAO,iBAAiB,aAAa,GAAG,MAAM;;;;;;;AAQ/C,SAAgB,GAAG,GAAG,OAA8C;AACnE,KAAI,MAAM,MAAM,MAAM,IAAI,EAAE,CAC3B,OAAM,IAAI,MAAM,2CAA2C;AAE5D,QAAO,iBAAiB,aAAa,GAAG,MAAM;;;;;;;AAQ/C,SAAgB,GAAG,GAAG,OAAmC;AACxD,QAAO,iBAAiB,aAAa,GAAG,MAAM;;;;;;;AAQ/C,SAAgB,GAAG,GAAG,OAAmC;AACxD,QAAO,iBAAiB,aAAa,GAAG,MAAM;;;;;;;AAQ/C,SAAgB,GAAG,GAAG,OAAmC;AACxD,QAAO,iBAAiB,aAAa,GAAG,MAAM;;;;;;;AAQ/C,SAAgB,GAAG,GAAG,OAA8C;AACnE,QAAO,iBAAiB,aAAa,GAAG,MAAM;;;;;;;AAQ/C,SAAgB,GAAG,GAAG,OAAmC;AACxD,KAAI,MAAM,MAAM,MAAM,IAAI,MAAM,EAAE,CACjC,OAAM,IAAI,MAAM,uCAAuC;AAExD,QAAO,iBAAiB,aAAa,GAAG,MAAM;;;;;;;AAQ/C,SAAgB,GAAG,GAAG,OAAmC;AACxD,QAAO,iBAAiB,aAAa,GAAG,MAAM"}

package/lib/hsms/HsmsActiveCommunicator.d.ts

@@ -0,0 +1,29 @@
+import { HsmsMessage } from "./HsmsMessage.js";
+import { SelectStatus } from "./enums/SelectStatus.js";
+import { HsmsCommunicator, HsmsCommunicatorConfig } from "./HsmsCommunicator.js";
+
+//#region src/hsms/HsmsActiveCommunicator.d.ts
+
+/**
+ * @description HsmsActiveCommunicator is a class that extends HsmsCommunicator and implements the active communicator logic.
+ */
+declare class HsmsActiveCommunicator extends HsmsCommunicator {
+  private shouldStop;
+  private reconnectTimer;
+  private connectionPromiseResolver;
+  private heartbeatTimer;
+  heartbeatIntervalMs: number;
+  constructor(config: HsmsCommunicatorConfig);
+  open(): Promise<void>;
+  private connect;
+  private scheduleReconnect;
+  private runHeartbeatLoop;
+  private startHeartbeat;
+  private stopHeartbeat;
+  protected handleSelectReq(msg: HsmsMessage): void;
+  untilConnected(): Promise<SelectStatus>;
+  close(): Promise<void>;
+}
+//#endregion
+export { HsmsActiveCommunicator };
+//# sourceMappingURL=HsmsActiveCommunicator.d.ts.map

package/lib/hsms/HsmsActiveCommunicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HsmsActiveCommunicator.d.ts","names":[],"sources":["../../src/hsms/HsmsActiveCommunicator.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAaA;AAOqB,cAPR,sBAAA,SAA+B,gBAAA,CAOvB;EAoBN,QAAA,UAAA;EAwG0B,QAAA,cAAA;EAIR,QAAA,yBAAA;EAAR,QAAA,cAAA;EAYT,mBAAA,EAAA,MAAA;EAnJ4B,WAAA,CAAA,MAAA,EAOvB,sBAPuB;EAAgB,IAAA,CAAA,CAAA,EA2B7C,OA3B6C,CAAA,IAAA,CAAA;;;;;;iCAmInB;oBAIhB,QAAQ;WAYjB"}

package/lib/hsms/HsmsActiveCommunicator.js

@@ -0,0 +1,123 @@
+import { RejectReason } from "./enums/RejectReason.js";
+import { SelectStatus } from "./enums/SelectStatus.js";
+import { HsmsCommunicator, HsmsState } from "./HsmsCommunicator.js";
+import { Socket } from "net";
+
+//#region src/hsms/HsmsActiveCommunicator.ts
+/**
+* @description HsmsActiveCommunicator is a class that extends HsmsCommunicator and implements the active communicator logic.
+*/
+var HsmsActiveCommunicator = class extends HsmsCommunicator {
+	shouldStop = false;
+	reconnectTimer = null;
+	connectionPromiseResolver = null;
+	heartbeatTimer = null;
+	heartbeatIntervalMs = 5e3;
+	constructor(config) {
+		super(config);
+		if (config.linkTestInterval !== void 0) this.heartbeatIntervalMs = config.linkTestInterval;
+		this.on("disconnected", () => {
+			this.stopHeartbeat();
+			if (!this.shouldStop) {
+				console.log(`Connection lost. Reconnecting in ${String(this.timeoutT5)}s...`);
+				this.scheduleReconnect();
+			}
+		});
+		this.on("selected", () => {
+			this.startHeartbeat();
+		});
+	}
+	async open() {
+		if (this.socket && !this.socket.destroyed) return;
+		this.shouldStop = false;
+		return new Promise((resolve) => {
+			this.connectionPromiseResolver = resolve;
+			this.connect();
+		});
+	}
+	connect() {
+		if (this.shouldStop) return;
+		const socket = new Socket();
+		const onError = (err) => {
+			socket.destroy();
+			console.log(`Connection failed: ${err.message}. Retrying in ${String(this.timeoutT5)}s...`);
+			if (!this.shouldStop) this.scheduleReconnect();
+		};
+		socket.once("error", onError);
+		socket.connect(this.port, this.ip, () => {
+			socket.removeListener("error", onError);
+			this.handleSocketEvents(socket);
+			this.sendSelectReq().then(() => {}).catch((err) => {
+				if (err instanceof Error) console.error(`SelectReq failed: ${err.message}`);
+				else console.error(`SelectReq failed: ${err}`);
+				if (!socket.destroyed) socket.destroy();
+			});
+			if (this.connectionPromiseResolver) {
+				this.connectionPromiseResolver();
+				this.connectionPromiseResolver = null;
+			}
+		});
+	}
+	scheduleReconnect() {
+		if (this.reconnectTimer) clearTimeout(this.reconnectTimer);
+		this.reconnectTimer = setTimeout(() => {
+			this.reconnectTimer = null;
+			this.connect();
+		}, this.timeoutT5 * 1e3);
+	}
+	async runHeartbeatLoop() {
+		if (this.state !== HsmsState.Selected || this.shouldStop) return;
+		try {
+			await this.sendLinkTestReq();
+		} catch (err) {
+			console.error("Heartbeat failed, closing connection:", err);
+			if (this.socket) this.socket.destroy();
+			return;
+		}
+		if (this.state === HsmsState.Selected && !this.shouldStop) this.heartbeatTimer = setTimeout(() => {
+			this.runHeartbeatLoop();
+		}, this.heartbeatIntervalMs);
+	}
+	startHeartbeat() {
+		this.stopHeartbeat();
+		this.heartbeatTimer = setTimeout(() => {
+			this.runHeartbeatLoop();
+		}, this.heartbeatIntervalMs);
+	}
+	stopHeartbeat() {
+		if (this.heartbeatTimer) {
+			clearTimeout(this.heartbeatTimer);
+			this.heartbeatTimer = null;
+		}
+	}
+	handleSelectReq(msg) {
+		this.sendReject(msg, RejectReason.NotSupportTypeS);
+	}
+	async untilConnected() {
+		if (this.state === HsmsState.Selected) return SelectStatus.Success;
+		return new Promise((resolve) => {
+			const onSelected = () => {
+				resolve(SelectStatus.Success);
+			};
+			this.once("selected", onSelected);
+		});
+	}
+	async close() {
+		this.shouldStop = true;
+		this.stopHeartbeat();
+		if (this.reconnectTimer) {
+			clearTimeout(this.reconnectTimer);
+			this.reconnectTimer = null;
+		}
+		if (this.socket) {
+			this.socket.end();
+			this.socket.destroy();
+			this.socket = null;
+		}
+		await Promise.resolve();
+	}
+};
+
+//#endregion
+export { HsmsActiveCommunicator };
+//# sourceMappingURL=HsmsActiveCommunicator.js.map

package/lib/hsms/HsmsActiveCommunicator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HsmsActiveCommunicator.js","names":[],"sources":["../../src/hsms/HsmsActiveCommunicator.ts"],"sourcesContent":["import { Socket } from \"net\";\nimport {\n\tHsmsCommunicator,\n\tHsmsCommunicatorConfig,\n\tHsmsState,\n} from \"./HsmsCommunicator.js\";\nimport { HsmsMessage } from \"./HsmsMessage.js\";\nimport { RejectReason } from \"./enums/RejectReason.js\";\nimport { SelectStatus } from \"./enums/SelectStatus.js\";\n\n/**\n * @description HsmsActiveCommunicator is a class that extends HsmsCommunicator and implements the active communicator logic.\n */\nexport class HsmsActiveCommunicator extends HsmsCommunicator {\n\tprivate shouldStop = false;\n\tprivate reconnectTimer: NodeJS.Timeout | null = null;\n\tprivate connectionPromiseResolver: (() => void) | null = null;\n\tprivate heartbeatTimer: NodeJS.Timeout | null = null;\n\tpublic heartbeatIntervalMs = 5000;\n\n\tconstructor(config: HsmsCommunicatorConfig) {\n\t\tsuper(config);\n\t\tif (config.linkTestInterval !== undefined) {\n\t\t\tthis.heartbeatIntervalMs = config.linkTestInterval;\n\t\t}\n\t\tthis.on(\"disconnected\", () => {\n\t\t\tthis.stopHeartbeat();\n\t\t\tif (!this.shouldStop) {\n\t\t\t\tconsole.log(\n\t\t\t\t\t`Connection lost. Reconnecting in ${String(this.timeoutT5)}s...`,\n\t\t\t\t);\n\t\t\t\tthis.scheduleReconnect();\n\t\t\t}\n\t\t});\n\n\t\tthis.on(\"selected\", () => {\n\t\t\tthis.startHeartbeat();\n\t\t});\n\t}\n\n\tasync open(): Promise<void> {\n\t\tif (this.socket && !this.socket.destroyed) {\n\t\t\treturn; // Already open\n\t\t}\n\n\t\tthis.shouldStop = false;\n\n\t\treturn new Promise((resolve) => {\n\t\t\tthis.connectionPromiseResolver = resolve;\n\t\t\tthis.connect();\n\t\t});\n\t}\n\n\tprivate connect() {\n\t\tif (this.shouldStop) return;\n\n\t\tconst socket = new Socket();\n\n\t\tconst onError = (err: Error) => {\n\t\t\tsocket.destroy();\n\t\t\tconsole.log(\n\t\t\t\t`Connection failed: ${err.message}. Retrying in ${String(this.timeoutT5)}s...`,\n\t\t\t);\n\t\t\tif (!this.shouldStop) {\n\t\t\t\tthis.scheduleReconnect();\n\t\t\t}\n\t\t};\n\n\t\tsocket.once(\"error\", onError);\n\n\t\tsocket.connect(this.port, this.ip, () => {\n\t\t\tsocket.removeListener(\"error\", onError);\n\t\t\tthis.handleSocketEvents(socket);\n\n\t\t\t// Automatically send SelectReq upon connection\n\t\t\tvoid this.sendSelectReq()\n\t\t\t\t.then(() => {\n\t\t\t\t\t// Select success, state updated in handleSelectRsp\n\t\t\t\t})\n\t\t\t\t.catch((err) => {\n\t\t\t\t\tif (err instanceof Error) {\n\t\t\t\t\t\tconsole.error(`SelectReq failed: ${err.message}`);\n\t\t\t\t\t} else {\n\t\t\t\t\t\tconsole.error(`SelectReq failed: ${err}`);\n\t\t\t\t\t}\n\t\t\t\t\t// If Select fails, close connection to trigger reconnect logic\n\t\t\t\t\tif (!socket.destroyed) {\n\t\t\t\t\t\tsocket.destroy();\n\t\t\t\t\t}\n\t\t\t\t});\n\n\t\t\tif (this.connectionPromiseResolver) {\n\t\t\t\tthis.connectionPromiseResolver();\n\t\t\t\tthis.connectionPromiseResolver = null;\n\t\t\t}\n\t\t});\n\t}\n\n\tprivate scheduleReconnect() {\n\t\tif (this.reconnectTimer) {\n\t\t\tclearTimeout(this.reconnectTimer);\n\t\t}\n\t\tthis.reconnectTimer = setTimeout(() => {\n\t\t\tthis.reconnectTimer = null;\n\t\t\tthis.connect();\n\t\t}, this.timeoutT5 * 1000);\n\t}\n\n\tprivate async runHeartbeatLoop() {\n\t\tif (this.state !== HsmsState.Selected || this.shouldStop) return;\n\n\t\ttry {\n\t\t\tawait this.sendLinkTestReq();\n\t\t} catch (err) {\n\t\t\tconsole.error(\"Heartbeat failed, closing connection:\", err);\n\t\t\t// Force close to trigger reconnect\n\t\t\tif (this.socket) {\n\t\t\t\tthis.socket.destroy();\n\t\t\t}\n\t\t\treturn; // Stop loop\n\t\t}\n\n\t\tif (this.state === HsmsState.Selected && !this.shouldStop) {\n\t\t\tthis.heartbeatTimer = setTimeout(() => {\n\t\t\t\tvoid this.runHeartbeatLoop();\n\t\t\t}, this.heartbeatIntervalMs);\n\t\t}\n\t}\n\n\tprivate startHeartbeat() {\n\t\tthis.stopHeartbeat();\n\t\t// Start first heartbeat after interval\n\t\tthis.heartbeatTimer = setTimeout(() => {\n\t\t\tvoid this.runHeartbeatLoop();\n\t\t}, this.heartbeatIntervalMs);\n\t}\n\n\tprivate stopHeartbeat() {\n\t\tif (this.heartbeatTimer) {\n\t\t\tclearTimeout(this.heartbeatTimer);\n\t\t\tthis.heartbeatTimer = null;\n\t\t}\n\t}\n\n\tprotected override handleSelectReq(msg: HsmsMessage) {\n\t\tvoid this.sendReject(msg, RejectReason.NotSupportTypeS);\n\t}\n\n\tasync untilConnected(): Promise<SelectStatus> {\n\t\tif (this.state === HsmsState.Selected) {\n\t\t\treturn SelectStatus.Success;\n\t\t}\n\t\treturn new Promise((resolve) => {\n\t\t\tconst onSelected = () => {\n\t\t\t\tresolve(SelectStatus.Success);\n\t\t\t};\n\t\t\tthis.once(\"selected\", onSelected);\n\t\t});\n\t}\n\n\tasync close(): Promise<void> {\n\t\tthis.shouldStop = true;\n\t\tthis.stopHeartbeat();\n\t\tif (this.reconnectTimer) {\n\t\t\tclearTimeout(this.reconnectTimer);\n\t\t\tthis.reconnectTimer = null;\n\t\t}\n\t\tif (this.socket) {\n\t\t\tthis.socket.end();\n\t\t\tthis.socket.destroy();\n\t\t\tthis.socket = null;\n\t\t}\n\t\tawait Promise.resolve();\n\t}\n}\n"],"mappings":"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"}

package/lib/hsms/HsmsCommunicator.d.ts

@@ -0,0 +1,70 @@
+import { AbstractSecs2Item } from "../core/secs2item/AbstractSecs2Item.js";
+import { SecsMessage } from "../core/AbstractSecsMessage.js";
+import { AbstractSecsCommunicator, SecsCommunicatorConfig, SecsCommunicatorEvents } from "../core/AbstractSecsCommunicator.js";
+import { RejectReason } from "./enums/RejectReason.js";
+import { HsmsMessage } from "./HsmsMessage.js";
+import { SelectStatus } from "./enums/SelectStatus.js";
+import { Socket } from "net";
+
+//#region src/hsms/HsmsCommunicator.d.ts
+declare enum HsmsState {
+  NotConnected = "NotConnected",
+  Connected = "Connected",
+  // TCP Connected
+  Selected = "Selected",
+}
+/**
+ * @description HsmsCommunicatorConfig is the configuration interface for HsmsCommunicator.
+ * @param ip The IP address of the remote device.
+ * @param port The port number of the remote device.
+ * @param linkTestInterval The interval in milliseconds to send link test messages.
+ */
+interface HsmsCommunicatorConfig extends SecsCommunicatorConfig {
+  ip: string;
+  port: number;
+  linkTestInterval?: number;
+}
+interface HsmsCommunicatorEvents extends SecsCommunicatorEvents {
+  selected: [];
+  deselected: [];
+}
+declare abstract class HsmsCommunicator extends AbstractSecsCommunicator<HsmsCommunicatorEvents> {
+  ip: string;
+  port: number;
+  protected socket: Socket | null;
+  protected state: HsmsState;
+  private buffer;
+  private t7Timer;
+  private t8Timer;
+  get connectionState(): HsmsState;
+  constructor(config: HsmsCommunicatorConfig);
+  protected sendBuffer(buffer: Buffer): Promise<void>;
+  protected createMessage(stream: number, func: number, wBit: boolean, body: AbstractSecs2Item | null, systemBytes: number): SecsMessage;
+  protected handleSocketEvents(socket: Socket): void;
+  private resetT7Timer;
+  private clearT7Timer;
+  private resetT8Timer;
+  private clearT8Timer;
+  private processBuffer;
+  private processHsmsMessage;
+  private handleControlMessage;
+  protected handleSelectReq(msg: HsmsMessage): void;
+  protected handleSelectRsp(msg: HsmsMessage): void;
+  protected handleLinkTestReq(msg: HsmsMessage): void;
+  protected handleLinkTestRsp(msg: HsmsMessage): void;
+  protected handleDeselectReq(msg: HsmsMessage): void;
+  protected handleDeselectRsp(msg: HsmsMessage): void;
+  protected handleSeparateReq(_msg: HsmsMessage): void;
+  protected sendSelectRsp(req: HsmsMessage, status: number): Promise<void>;
+  protected sendDeselectRsp(req: HsmsMessage, status: number): Promise<void>;
+  protected sendLinkTestRsp(req: HsmsMessage): Promise<void>;
+  protected sendReject(req: HsmsMessage, reason: RejectReason): Promise<void>;
+  send(stream: number, func: number, wBit: boolean, body?: AbstractSecs2Item | null): Promise<SecsMessage | null>;
+  sendSelectReq(): Promise<SelectStatus>;
+  sendLinkTestReq(): Promise<void>;
+  sendSeparateReq(): Promise<void>;
+  private rejectAllTransactions;
+}
+//#endregion
+export { HsmsCommunicator, HsmsCommunicatorConfig, HsmsCommunicatorEvents, HsmsState };
+//# sourceMappingURL=HsmsCommunicator.d.ts.map

package/lib/hsms/HsmsCommunicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HsmsCommunicator.d.ts","names":[],"sources":["../../src/hsms/HsmsCommunicator.ts"],"sourcesContent":[],"mappings":";;;;;;;;;aAaY,SAAA;;EAAA,SAAA,GAAS,WAAA;EAAA;EAYJ,QAAA,GAAA,UAAA;AAMjB;AAKA;;;;;;AAuBoC,UAlCnB,sBAAA,SAA+B,sBAkCZ,CAAA;EAAS,EAAA,EAAA,MAAA;EAiBrC,IAAA,EAAA,MAAA;EAEJ,gBAAA,CAAA,EAAA,MAAA;;AAwL4B,UAvOf,sBAAA,SAA+B,sBAuOhB,CAAA;EAgBA,QAAA,EAAA,EAAA;EAsBE,UAAA,EAAA,EAAA;;AAeA,uBAvRZ,gBAAA,SAAyB,wBAuRb,CAvRsC,sBAuRtC,CAAA,CAAA;EAWA,EAAA,EAAA,MAAA;EAiBC,IAAA,EAAA,MAAA;EAUC,UAAA,MAAA,EAzTjB,MAyTiB,GAAA,IAAA;EAA2B,UAAA,KAAA,EAxT7C,SAwT6C;EAKzB,QAAA,MAAA;EAA2B,QAAA,OAAA;EAK3B,QAAA,OAAA;EAAW,IAAA,eAAA,CAAA,CAAA,EA1TlB,SA0TkB;EAKhB,WAAA,CAAA,MAAA,EA3TZ,sBA2TY;EAAqB,UAAA,UAAA,CAAA,MAAA,EArTlB,MAqTkB,CAAA,EArTT,OAqTS,CAAA,IAAA,CAAA;EAAY,UAAA,aAAA,CAAA,MAAA,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,EAAA,IAAA,EAAA,OAAA,EAAA,IAAA,EApS1D,iBAoS0D,GAAA,IAAA,EAAA,WAAA,EAAA,MAAA,CAAA,EAlS9D,WAkS8D;EAS1D,UAAA,kBAAA,CAAA,MAAA,EA7R8B,MA6R9B,CAAA,EAAA,IAAA;EACI,QAAA,YAAA;EAAR,QAAA,YAAA;EAQmC,QAAA,YAAA;EAAR,QAAA,YAAA;EA4BE,QAAA,aAAA;EA4BA,QAAA,kBAAA;EAtZc,QAAA,oBAAA;EAAwB,UAAA,eAAA,CAAA,GAAA,EAkOvC,WAlOuC,CAAA,EAAA,IAAA;iCAkPvC;mCAsBE;mCAIA;mCAWA;mCAWA;oCAiBC;+BAUC,8BAA2B;iCAKzB,8BAA2B;iCAK3B,cAAW;4BAKhB,qBAAqB,eAAY;2DAS1D,2BACJ,QAAQ;mBAQmB,QAAQ;qBA4BN;qBA4BA"}