node-opcua-utils 2.98.0 → 2.104.0

package/dist/buffer_ellipsis.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="node" />
+/**
+ * @module node-opcua-utils
+ */
+export declare function buffer_ellipsis(buffer: Buffer, start?: number, end?: number): string;

package/dist/buffer_ellipsis.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buffer_ellipsis = void 0;
+/**
+ * @module node-opcua-utils
+ */
+function buffer_ellipsis(buffer, start, end) {
+    start = start || 0;
+    end = end || buffer.length;
+    if (end - start < 40) {
+        return buffer.subarray(start, end).toString("hex");
+    }
+    return buffer.subarray(start, start + 10).toString("hex") + " ... " + buffer.subarray(end - 10, end).toString("hex");
+}
+exports.buffer_ellipsis = buffer_ellipsis;
+exports.buffer_ellipsis = buffer_ellipsis;
+//# sourceMappingURL=buffer_ellipsis.js.map

package/dist/buffer_ellipsis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer_ellipsis.js","sourceRoot":"","sources":["../source/buffer_ellipsis.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,SAAgB,eAAe,CAAC,MAAc,EAAE,KAAc,EAAE,GAAY;IACxE,KAAK,GAAG,KAAK,IAAI,CAAC,CAAC;IACnB,GAAG,GAAG,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC;IAC3B,IAAI,GAAG,GAAG,KAAK,GAAG,EAAE,EAAE;QAClB,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;KACtD;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACzH,CAAC;AAPD,0CAOC;AAED,OAAO,CAAC,eAAe,GAAG,eAAe,CAAC"}

package/dist/compare_buffers.d.ts

@@ -0,0 +1,2 @@
+/// <reference types="node" />
+export declare function compare_buffers(buf1: Buffer, buf2: Buffer, max_length?: number): void;

package/dist/compare_buffers.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compare_buffers = void 0;
+/**
+ * @module node-opcua-utils
+ */
+// tslint:disable:no-console
+const chalk_1 = __importDefault(require("chalk"));
+const buffer_ellipsis_1 = require("./buffer_ellipsis");
+function compare_buffers(buf1, buf2, max_length) {
+    max_length = max_length || buf2.length;
+    const block_length = 80;
+    let cursor = 0;
+    while (cursor < max_length) {
+        const slice1 = buf1.subarray(cursor, cursor + block_length);
+        const slice2 = buf2.subarray(cursor, cursor + block_length);
+        if (slice2.toString("hex") !== slice1.toString("hex")) {
+            console.log("pos = ", cursor);
+            console.log("slice1 :", chalk_1.default.yellow((0, buffer_ellipsis_1.buffer_ellipsis)(slice1)));
+            console.log("slice2 :", chalk_1.default.blue((0, buffer_ellipsis_1.buffer_ellipsis)(slice2)));
+        }
+        cursor += block_length;
+    }
+    // xx buf1.length.should.equal(max_length);
+}
+exports.compare_buffers = compare_buffers;
+//# sourceMappingURL=compare_buffers.js.map

package/dist/compare_buffers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare_buffers.js","sourceRoot":"","sources":["../source/compare_buffers.ts"],"names":[],"mappings":";;;;;;AAAA;;GAEG;AACH,4BAA4B;AAC5B,kDAA0B;AAC1B,uDAAoD;AAEpD,SAAgB,eAAe,CAAC,IAAY,EAAE,IAAY,EAAE,UAAmB;IAC3E,UAAU,GAAG,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC;IACvC,MAAM,YAAY,GAAG,EAAE,CAAC;IACxB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,OAAO,MAAM,GAAG,UAAU,EAAE;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC;QAC5D,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE;YACnD,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,eAAK,CAAC,MAAM,CAAC,IAAA,iCAAe,EAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC/D,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,eAAK,CAAC,IAAI,CAAC,IAAA,iCAAe,EAAC,MAAM,CAAC,CAAC,CAAC,CAAC;SAChE;QACD,MAAM,IAAI,YAAY,CAAC;KAC1B;IACD,2CAA2C;AAC/C,CAAC;AAfD,0CAeC"}

package/dist/function_variadic.d.ts

@@ -0,0 +1 @@
+export type FunctionVariadic = (...args: any[]) => void;

package/dist/function_variadic.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=function_variadic.js.map

package/dist/function_variadic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"function_variadic.js","sourceRoot":"","sources":["../source/function_variadic.ts"],"names":[],"mappings":""}

package/dist/get_clock_tick.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @module node-opcua-utils
+ */
+export declare let get_clock_tick: () => number;

package/dist/get_clock_tick.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.get_clock_tick = void 0;
+if (typeof process === "object" && process.hrtime) {
+    const tickOrigin = process.hrtime();
+    // clock it as a double in millisecond
+    // so we can measure very tiny time intervals
+    exports.get_clock_tick = () => {
+        const hrt = process.hrtime(tickOrigin);
+        const r = (hrt[0]) * 1000.0 + Math.ceil((hrt[1] / 1e6) * 1000) / 1000;
+        return r;
+    };
+}
+else {
+    exports.get_clock_tick = () => Date.now();
+}
+//# sourceMappingURL=get_clock_tick.js.map

package/dist/get_clock_tick.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_clock_tick.js","sourceRoot":"","sources":["../source/get_clock_tick.ts"],"names":[],"mappings":";;;AAMA,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,EAAE;IAC/C,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IACpC,sCAAsC;IACtC,6CAA6C;IAC7C,sBAAc,GAAG,GAAG,EAAE;QAClB,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;QACtE,OAAO,CAAC,CAAC;IACb,CAAC,CAAC;CACL;KAAM;IACH,sBAAc,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;CACrC"}

package/dist/get_function_parameters_name.d.ts

@@ -0,0 +1,2 @@
+import { FunctionVariadic } from "./function_variadic";
+export declare function getFunctionParameterNames(func: FunctionVariadic): string[];

package/dist/get_function_parameters_name.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFunctionParameterNames = void 0;
+/**
+ * @module node-opcua-utils
+ */
+const STRIP_COMMENTS = /((\/\/.*$)|(\/\*[\s\S]*?\*\/))/gm;
+const ARGUMENT_NAMES = /([^\s,]+)/g;
+function getFunctionParameterNames(func) {
+    const fnStr = func.toString().replace(STRIP_COMMENTS, "");
+    const result = fnStr.slice(fnStr.indexOf("(") + 1, fnStr.indexOf(")")).match(ARGUMENT_NAMES);
+    if (!result) {
+        return [];
+    }
+    return result;
+}
+exports.getFunctionParameterNames = getFunctionParameterNames;
+//# sourceMappingURL=get_function_parameters_name.js.map

package/dist/get_function_parameters_name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_function_parameters_name.js","sourceRoot":"","sources":["../source/get_function_parameters_name.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAM,cAAc,GAAG,kCAAkC,CAAC;AAC1D,MAAM,cAAc,GAAG,YAAY,CAAC;AAGpC,SAAgB,yBAAyB,CAAC,IAAsB;IAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC7F,IAAI,CAAC,MAAM,EAAE;QACT,OAAO,EAAE,CAAC;KACb;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAPD,8DAOC"}

package/dist/hrtime.d.ts

@@ -0,0 +1,2 @@
+export type HRTimeFunc = (time?: [number, number]) => [number, number];
+export declare const hrtime: HRTimeFunc;

package/dist/hrtime.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hrtime = void 0;
+// polyfil for window.performance.now
+const performance = (typeof global === "object" && global.performance) || {};
+const performanceNow = performance.now ||
+    performance.mozNow ||
+    performance.msNow ||
+    performance.oNow ||
+    performance.webkitNow ||
+    function () {
+        return new Date().getTime();
+    };
+// generate timestamp or delta
+// see http://nodejs.org/api/process.html#process_process_hrtime
+function hrtime_for_browser(previousTimestamp) {
+    previousTimestamp = previousTimestamp || [0, 0];
+    const clocktime = performanceNow.call(performance) * 1e-3;
+    let seconds = Math.floor(clocktime);
+    let nanoseconds = Math.floor((clocktime % 1) * 1e9);
+    if (previousTimestamp) {
+        seconds = seconds - previousTimestamp[0];
+        nanoseconds = nanoseconds - previousTimestamp[1];
+        if (nanoseconds < 0) {
+            seconds--;
+            nanoseconds += 1e9;
+        }
+    }
+    return [seconds, nanoseconds];
+}
+exports.hrtime = typeof process === "object" ? (process.hrtime || hrtime_for_browser) : hrtime_for_browser;
+//# sourceMappingURL=hrtime.js.map

package/dist/hrtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hrtime.js","sourceRoot":"","sources":["../source/hrtime.ts"],"names":[],"mappings":";;;AAAA,qCAAqC;AACrC,MAAM,WAAW,GAAQ,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAK,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;AACnF,MAAM,cAAc,GAChB,WAAW,CAAC,GAAG;IACf,WAAW,CAAC,MAAM;IAClB,WAAW,CAAC,KAAK;IACjB,WAAW,CAAC,IAAI;IAChB,WAAW,CAAC,SAAS;IACrB;QACI,OAAO,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;IAChC,CAAC,CAAC;AAEN,8BAA8B;AAC9B,gEAAgE;AAChE,SAAS,kBAAkB,CAAC,iBAAoC;IAE5D,iBAAiB,GAAG,iBAAiB,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEhD,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;IAC1D,IAAI,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACpC,IAAI,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IACpD,IAAI,iBAAiB,EAAE;QACnB,OAAO,GAAG,OAAO,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;QACzC,WAAW,GAAG,WAAW,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;QACjD,IAAI,WAAW,GAAG,CAAC,EAAE;YACjB,OAAO,EAAE,CAAC;YACV,WAAW,IAAI,GAAG,CAAC;SACtB;KACJ;IACD,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AAClC,CAAC;AAEY,QAAA,MAAM,GAAe,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAoB,IAAI,kBAAkB,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * set a flag
+ * @method set_flag
+ */
+export declare function set_flag(value: number, mask: number | {
+    value: number;
+}): number;
+/**
+ * check if a set of bits are set in the values
+ * @method check_flag
+ */
+export declare function check_flag(value: number, mask: number | {
+    value: number;
+}): boolean;
+export declare function isNullOrUndefined(value: unknown | undefined): boolean;
+export { buffer_ellipsis } from "./buffer_ellipsis";
+export { capitalizeFirstLetter, lowerFirstLetter } from "./string_utils";
+export { getObjectClassName } from "./object_classname";
+export { get_clock_tick } from "./get_clock_tick";
+export { compare_buffers } from "./compare_buffers";
+export { getFunctionParameterNames } from "./get_function_parameters_name";
+export * from "./watchdog";
+export { setDeprecated } from "./set_deprecated";
+export { replaceBufferWithHexDump } from "./replace_buffer_with_hex_dump";
+export * from "./timestamp";
+export * from "./line_file";
+export * from "./match_uri";
+export { hrtime } from "./hrtime";

package/dist/index.js

@@ -0,0 +1,75 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hrtime = exports.replaceBufferWithHexDump = exports.setDeprecated = exports.getFunctionParameterNames = exports.compare_buffers = exports.get_clock_tick = exports.getObjectClassName = exports.lowerFirstLetter = exports.capitalizeFirstLetter = exports.buffer_ellipsis = exports.isNullOrUndefined = exports.check_flag = exports.set_flag = void 0;
+/**
+ * @module node-opcua-utils
+ */
+// tslint:disable:no-bitwise
+const node_opcua_assert_1 = require("node-opcua-assert");
+/**
+ * set a flag
+ * @method set_flag
+ */
+function set_flag(value, mask) {
+    if (mask.value) {
+        mask = mask.value;
+    }
+    (0, node_opcua_assert_1.assert)(!Object.prototype.hasOwnProperty.call(mask, "value"));
+    (0, node_opcua_assert_1.assert)(mask !== undefined);
+    return value | mask;
+}
+exports.set_flag = set_flag;
+/**
+ * check if a set of bits are set in the values
+ * @method check_flag
+ */
+function check_flag(value, mask) {
+    if (mask.value) {
+        mask = mask.value;
+    }
+    (0, node_opcua_assert_1.assert)(!Object.prototype.hasOwnProperty.call(mask, "value"));
+    return (value & mask) === mask;
+}
+exports.check_flag = check_flag;
+function isNullOrUndefined(value) {
+    return value === undefined || value === null;
+}
+exports.isNullOrUndefined = isNullOrUndefined;
+var buffer_ellipsis_1 = require("./buffer_ellipsis");
+Object.defineProperty(exports, "buffer_ellipsis", { enumerable: true, get: function () { return buffer_ellipsis_1.buffer_ellipsis; } });
+var string_utils_1 = require("./string_utils");
+Object.defineProperty(exports, "capitalizeFirstLetter", { enumerable: true, get: function () { return string_utils_1.capitalizeFirstLetter; } });
+Object.defineProperty(exports, "lowerFirstLetter", { enumerable: true, get: function () { return string_utils_1.lowerFirstLetter; } });
+var object_classname_1 = require("./object_classname");
+Object.defineProperty(exports, "getObjectClassName", { enumerable: true, get: function () { return object_classname_1.getObjectClassName; } });
+var get_clock_tick_1 = require("./get_clock_tick");
+Object.defineProperty(exports, "get_clock_tick", { enumerable: true, get: function () { return get_clock_tick_1.get_clock_tick; } });
+var compare_buffers_1 = require("./compare_buffers");
+Object.defineProperty(exports, "compare_buffers", { enumerable: true, get: function () { return compare_buffers_1.compare_buffers; } });
+var get_function_parameters_name_1 = require("./get_function_parameters_name");
+Object.defineProperty(exports, "getFunctionParameterNames", { enumerable: true, get: function () { return get_function_parameters_name_1.getFunctionParameterNames; } });
+__exportStar(require("./watchdog"), exports);
+var set_deprecated_1 = require("./set_deprecated");
+Object.defineProperty(exports, "setDeprecated", { enumerable: true, get: function () { return set_deprecated_1.setDeprecated; } });
+var replace_buffer_with_hex_dump_1 = require("./replace_buffer_with_hex_dump");
+Object.defineProperty(exports, "replaceBufferWithHexDump", { enumerable: true, get: function () { return replace_buffer_with_hex_dump_1.replaceBufferWithHexDump; } });
+__exportStar(require("./timestamp"), exports);
+__exportStar(require("./line_file"), exports);
+__exportStar(require("./match_uri"), exports);
+var hrtime_1 = require("./hrtime");
+Object.defineProperty(exports, "hrtime", { enumerable: true, get: function () { return hrtime_1.hrtime; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA;;GAEG;AACH,4BAA4B;AAC5B,yDAA2C;AAE3C;;;GAGG;AACH,SAAgB,QAAQ,CAAC,KAAa,EAAE,IAAgC;IACpE,IAAK,IAAY,CAAC,KAAK,EAAE;QACrB,IAAI,GAAI,IAAY,CAAC,KAAK,CAAC;KAC9B;IACD,IAAA,0BAAM,EAAC,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7D,IAAA,0BAAM,EAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAC3B,OAAO,KAAK,GAAI,IAAe,CAAC;AACpC,CAAC;AAPD,4BAOC;AACD;;;GAGG;AACH,SAAgB,UAAU,CAAC,KAAa,EAAE,IAAgC;IACtE,IAAK,IAAY,CAAC,KAAK,EAAE;QACrB,IAAI,GAAI,IAAY,CAAC,KAAK,CAAC;KAC9B;IACD,IAAA,0BAAM,EAAC,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7D,OAAO,CAAC,KAAK,GAAI,IAAe,CAAC,KAAM,IAAe,CAAC;AAC3D,CAAC;AAND,gCAMC;AAED,SAAgB,iBAAiB,CAAC,KAA0B;IACxD,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;AACjD,CAAC;AAFD,8CAEC;AAED,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,+CAAyE;AAAhE,qHAAA,qBAAqB,OAAA;AAAE,gHAAA,gBAAgB,OAAA;AAChD,uDAAwD;AAA/C,sHAAA,kBAAkB,OAAA;AAC3B,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,+EAA2E;AAAlE,yIAAA,yBAAyB,OAAA;AAClC,6CAA2B;AAC3B,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,+EAA0E;AAAjE,wIAAA,wBAAwB,OAAA;AACjC,8CAA4B;AAC5B,8CAA4B;AAC5B,8CAA4B;AAC5B,mCAAgC;AAAxB,gGAAA,MAAM,OAAA"}

package/dist/line_file.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @module node-opcua-utils
+ */
+export declare class LineFile {
+    private _line;
+    constructor();
+    write(...args: string[]): void;
+    toString(endOfLine?: "\n" | "\r"): string;
+}

package/dist/line_file.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * @module node-opcua-utils
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LineFile = void 0;
+class LineFile {
+    constructor() {
+        this._line = [];
+    }
+    write(...args) {
+        let str = "";
+        // tslint:disable:prefer-for-of
+        for (let i = 0; i < args.length; i++) {
+            str += args[i];
+        }
+        this._line.push(str);
+    }
+    toString(endOfLine = "\n") {
+        return this._line.join(endOfLine);
+    }
+}
+exports.LineFile = LineFile;
+//# sourceMappingURL=line_file.js.map

package/dist/line_file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"line_file.js","sourceRoot":"","sources":["../source/line_file.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,MAAa,QAAQ;IAGjB;QACI,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IACpB,CAAC;IAEM,KAAK,CAAC,GAAG,IAAc;QAC1B,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,+BAA+B;QAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YAClC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;SAClB;QACD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAEM,QAAQ,CAAC,YAAyB,IAAI;QACzC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;CACJ;AAnBD,4BAmBC"}

package/dist/match_uri.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @module node-opcua-utils
+ */
+/**
+ * returns true if two endpoint matches the same address:
+ *
+ * @see https://www.dnscheck.co/faq
+ * @see https://tools.ietf.org/html/rfc4343 : Domain Name System (DNS) Case Insensitivity Clarification
+ *
+ */
+export declare function matchUri(endpointUri1: string | null, endpointUri2: string | null): boolean;

package/dist/match_uri.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchUri = void 0;
+/**
+ * @module node-opcua-utils
+ */
+/**
+ * returns true if two endpoint matches the same address:
+ *
+ * @see https://www.dnscheck.co/faq
+ * @see https://tools.ietf.org/html/rfc4343 : Domain Name System (DNS) Case Insensitivity Clarification
+ *
+ */
+function matchUri(endpointUri1, endpointUri2) {
+    if (endpointUri1 === null) {
+        return endpointUri2 === null;
+    }
+    if (endpointUri2 === null) {
+        return endpointUri1 === null;
+    }
+    return endpointUri1.toLowerCase() === endpointUri2.toLowerCase();
+}
+exports.matchUri = matchUri;
+//# sourceMappingURL=match_uri.js.map

package/dist/match_uri.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match_uri.js","sourceRoot":"","sources":["../source/match_uri.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH;;;;;;GAMG;AACH,SAAgB,QAAQ,CAAC,YAA2B,EAAE,YAA2B;IAC7E,IAAI,YAAY,KAAK,IAAI,EAAE;QACvB,OAAO,YAAY,KAAK,IAAI,CAAC;KAChC;IACD,IAAI,YAAY,KAAK,IAAI,EAAE;QACvB,OAAO,YAAY,KAAK,IAAI,CAAC;KAChC;IACD,OAAO,YAAY,CAAC,WAAW,EAAE,KAAK,YAAY,CAAC,WAAW,EAAE,CAAC;AACrE,CAAC;AARD,4BAQC"}

package/dist/object_classname.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @module node-opcua-utils
+ */
+/**
+ * @method getObjectClassName
+ * @param obj
+ * @return {string}
+ */
+export declare function getObjectClassName(obj: unknown): string;

package/dist/object_classname.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getObjectClassName = void 0;
+/**
+ * @module node-opcua-utils
+ */
+/**
+ * @method getObjectClassName
+ * @param obj
+ * @return {string}
+ */
+function getObjectClassName(obj) {
+    return Object.prototype.toString.call(obj).slice(8, -1);
+}
+exports.getObjectClassName = getObjectClassName;
+//# sourceMappingURL=object_classname.js.map

package/dist/object_classname.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object_classname.js","sourceRoot":"","sources":["../source/object_classname.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,GAAY;IAC3C,OAAO,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC5D,CAAC;AAFD,gDAEC"}

package/dist/replace_buffer_with_hex_dump.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @module node-opcua-utils
+ */
+export declare function replaceBufferWithHexDump(obj: Record<string, {
+    toString(format: string): void;
+}>): any;

package/dist/replace_buffer_with_hex_dump.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.replaceBufferWithHexDump = void 0;
+/**
+ * @module node-opcua-utils
+ */
+function replaceBufferWithHexDump(obj) {
+    for (const p in obj) {
+        if (Object.prototype.hasOwnProperty.call(obj, p)) {
+            if (obj[p] instanceof Buffer) {
+                obj[p] = "<BUFFER>" + obj[p].toString("hex") + "</BUFFER>";
+            }
+            else if (typeof obj[p] === "object") {
+                replaceBufferWithHexDump(obj[p]);
+            }
+        }
+    }
+    return obj;
+}
+exports.replaceBufferWithHexDump = replaceBufferWithHexDump;
+//# sourceMappingURL=replace_buffer_with_hex_dump.js.map

package/dist/replace_buffer_with_hex_dump.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace_buffer_with_hex_dump.js","sourceRoot":"","sources":["../source/replace_buffer_with_hex_dump.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,SAAgB,wBAAwB,CAAC,GAAuD;IAC5F,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE;QACjB,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE;YAC9C,IAAI,GAAG,CAAC,CAAC,CAAC,YAAY,MAAM,EAAE;gBAC1B,GAAG,CAAC,CAAC,CAAC,GAAG,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC;aAC9D;iBAAM,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE;gBACnC,wBAAwB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;aACpC;SACJ;KACJ;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAXD,4DAWC"}

package/dist/set_deprecated.d.ts

@@ -0,0 +1,2 @@
+import { FunctionVariadic } from "./function_variadic";
+export declare function setDeprecated(constructor: FunctionVariadic, methodName: string, helpString: string): void;

package/dist/set_deprecated.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setDeprecated = void 0;
+/**
+ * @module node-opcua-utils
+ */
+// tslint:disable:ban-types
+const chalk_1 = __importDefault(require("chalk"));
+const node_opcua_assert_1 = require("node-opcua-assert");
+/* istanbul ignore next */
+function setDeprecated(constructor, methodName, helpString) {
+    const oldMethod = constructor.prototype[methodName];
+    (0, node_opcua_assert_1.assert)(oldMethod instanceof Function, "expecting a valid " + methodName + "method on class " + constructor.constructor.name);
+    let counter = 0;
+    constructor.prototype[methodName] = function (...args) {
+        if (counter % 1000 === 0) {
+            // tslint:disable:no-console
+            console.log(chalk_1.default.green("Warning !"), chalk_1.default.green(chalk_1.default.bold(constructor.name + "#" + methodName), " is now deprecated"));
+            console.log("         ", helpString);
+        }
+        counter++;
+        return oldMethod.call(this, ...args);
+    };
+}
+exports.setDeprecated = setDeprecated;
+//# sourceMappingURL=set_deprecated.js.map

package/dist/set_deprecated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set_deprecated.js","sourceRoot":"","sources":["../source/set_deprecated.ts"],"names":[],"mappings":";;;;;;AAAA;;GAEG;AACH,2BAA2B;AAC3B,kDAA0B;AAC1B,yDAA2C;AAI3C,0BAA0B;AAC1B,SAAgB,aAAa,CAAC,WAA6B,EAAE,UAAkB,EAAE,UAAkB;IAC/F,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAEpD,IAAA,0BAAM,EAAC,SAAS,YAAY,QAAQ,EAAE,oBAAoB,GAAG,UAAU,GAAG,kBAAkB,GAAG,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAE7H,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,UAAU,GAAG,IAAW;QACxD,IAAI,OAAO,GAAG,IAAI,KAAK,CAAC,EAAE;YACtB,4BAA4B;YAC5B,OAAO,CAAC,GAAG,CACP,eAAK,CAAC,KAAK,CAAC,WAAW,CAAC,EACxB,eAAK,CAAC,KAAK,CAAC,eAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,GAAG,GAAG,GAAG,UAAU,CAAC,EAAE,oBAAoB,CAAC,CACrF,CAAC;YACF,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;SACxC;QACD,OAAO,EAAE,CAAC;QACV,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;IACzC,CAAC,CAAC;AACN,CAAC;AAlBD,sCAkBC"}

package/dist/string_utils.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @module node-opcua-utils
+ */
+export declare function capitalizeFirstLetter(str: string): string;
+export declare function isUpperCaseChar(c: string): boolean;
+export declare function isAlpha(c: string): boolean;
+export declare function countUpperCaseSlow(str: string): number;
+export declare function countAlphaSlow(str: string): number;
+export declare function countUpperCase(str: string): number;
+export declare function countAlpha(str: string): number;
+/**
+ *
+ * lowerFirstLetter convert a OPCUA Identifier to a javascript Identifier
+ *
+ * @summary
+ *
+ *  OPCUA and Javascript use two different rules to build identifiers.
+ *
+ *  OPCUA Identifier usually starts with a upper case letter and word are join together, this is known as
+ *  the Pascal case, or CapitalizedWords convention.  (for instance HelloWorld)
+ *  But sometime, OPCUA identifiers do not follow this convention strictly and we can find various
+ *  other convention being applied such as underscore between word, or addition of ACRONYMIC prefixes.
+ *  On it's own, this causes great confusion and inconsistency in programming style.
+ *
+ *  Javascript uses a slightly different convention called camelCase where word are joined together
+ *  and inner words starts with a capital letter whereas first word starts with a lower case letter.
+ *  (for instance helloWorld)
+ *
+ *  In node-opcua we have taken the opinionated decision to consistently use camelCase convention for
+ *  object properties so that all the code look nice and consistent.
+ *  the lowerFirstLetter method can be used to easily convert from the OPCUA  naming convention
+ *  to javascript naming convention by applying the following rules.
+ *
+ *   * each ascii sequence in a identifier will be converted to lower camel case.
+ *   * when an identifier only contains upper case letter then it will be untouched. ( i.e CQDF => CQFD)
+ *     (this rules helps to preserve acronyms)
+ *   * when a identifier starts with more than one UpperCase letter but still contain lowercase letter
+ *     then the first Uppercase letter excluding the last one will be converted to lower case
+ *     ( ie:  EURange = > euRange)
+ *   * when a identifier contains several sequences delimited with underscores (_) the above rules
+ *     will be applied to each of the element of the sequence
+ *     ( ie: ALM_FlowOutOfTolerance => ALM_flowOutOfTolerance ( ALM=>ALM , FlowOutOfTolerance=>flowOutOfTolerance)
+ *
+ * @reference
+ *    * https://en.wikipedia.org/wiki/Camel_case
+ *    * https://en.wikipedia.org/wiki/Hungarian_notation
+ *    * http://wiki.c2.com/?UnderscoreVersusCapitalAndLowerCaseVariableNaming
+ *
+ *
+ *
+ * @example
+ *  HelloWorld => helloWorld
+ *  XAxis      => xAxis
+ *  EURange    => euRange
+ *  DATE       => DATE
+ *  XYZ        => XYZ
+ *  AB         => AB
+ *  Ab         => ab
+ *  A          => a
+ *  T1ABC8     => T1ABC8
+ *  F_ABC_D    => F_ABC_D
+ *  ALM_Timeout    => ALM_timeout
+ *  SV_GasOn       => SV_gasOn
+ *  DI_VAL_FlowImp => DI_VAL_flowImp
+ */
+export declare function lowerFirstLetter(str: string): string;

package/dist/string_utils.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lowerFirstLetter = exports.countAlpha = exports.countUpperCase = exports.countAlphaSlow = exports.countUpperCaseSlow = exports.isAlpha = exports.isUpperCaseChar = exports.capitalizeFirstLetter = void 0;
+/**
+ * @module node-opcua-utils
+ */
+// tslint:disable:variable-name
+function capitalizeFirstLetter(str) {
+    if (str == null) {
+        return str;
+    }
+    return str.substring(0, 1).toUpperCase() + str.substring(1);
+}
+exports.capitalizeFirstLetter = capitalizeFirstLetter;
+const ACode = "A".charCodeAt(0);
+const ZCode = "Z".charCodeAt(0);
+function isUpperCaseChar(c) {
+    const code = c.charCodeAt(0);
+    return code >= ACode && code <= ZCode;
+}
+exports.isUpperCaseChar = isUpperCaseChar;
+const aCode = "a".charCodeAt(0);
+const zCode = "z".charCodeAt(0);
+function isAlpha(c) {
+    const code = c.charCodeAt(0);
+    return (code >= ACode && code <= ZCode) || (code >= aCode && code <= zCode);
+}
+exports.isAlpha = isAlpha;
+function countUpperCaseSlow(str) {
+    return str.split("").reduce((p, c) => p + (isUpperCaseChar(c) ? 1 : 0), 0);
+}
+exports.countUpperCaseSlow = countUpperCaseSlow;
+function countAlphaSlow(str) {
+    return str.split("").reduce((p, c) => p + (isAlpha(c) ? 1 : 0), 0);
+}
+exports.countAlphaSlow = countAlphaSlow;
+function countUpperCase(str) {
+    let count = 0;
+    const n = str.length;
+    for (let i = 0; i < n; i++) {
+        count += isUpperCaseChar(str[i]) ? 1 : 0;
+    }
+    return count;
+}
+exports.countUpperCase = countUpperCase;
+function countAlpha(str) {
+    let count = 0;
+    const n = str.length;
+    for (let i = 0; i < n; i++) {
+        count += isAlpha(str[i]) ? 1 : 0;
+    }
+    return count;
+}
+exports.countAlpha = countAlpha;
+/**
+ *
+ * lowerFirstLetter convert a OPCUA Identifier to a javascript Identifier
+ *
+ * @summary
+ *
+ *  OPCUA and Javascript use two different rules to build identifiers.
+ *
+ *  OPCUA Identifier usually starts with a upper case letter and word are join together, this is known as
+ *  the Pascal case, or CapitalizedWords convention.  (for instance HelloWorld)
+ *  But sometime, OPCUA identifiers do not follow this convention strictly and we can find various
+ *  other convention being applied such as underscore between word, or addition of ACRONYMIC prefixes.
+ *  On it's own, this causes great confusion and inconsistency in programming style.
+ *
+ *  Javascript uses a slightly different convention called camelCase where word are joined together
+ *  and inner words starts with a capital letter whereas first word starts with a lower case letter.
+ *  (for instance helloWorld)
+ *
+ *  In node-opcua we have taken the opinionated decision to consistently use camelCase convention for
+ *  object properties so that all the code look nice and consistent.
+ *  the lowerFirstLetter method can be used to easily convert from the OPCUA  naming convention
+ *  to javascript naming convention by applying the following rules.
+ *
+ *   * each ascii sequence in a identifier will be converted to lower camel case.
+ *   * when an identifier only contains upper case letter then it will be untouched. ( i.e CQDF => CQFD)
+ *     (this rules helps to preserve acronyms)
+ *   * when a identifier starts with more than one UpperCase letter but still contain lowercase letter
+ *     then the first Uppercase letter excluding the last one will be converted to lower case
+ *     ( ie:  EURange = > euRange)
+ *   * when a identifier contains several sequences delimited with underscores (_) the above rules
+ *     will be applied to each of the element of the sequence
+ *     ( ie: ALM_FlowOutOfTolerance => ALM_flowOutOfTolerance ( ALM=>ALM , FlowOutOfTolerance=>flowOutOfTolerance)
+ *
+ * @reference
+ *    * https://en.wikipedia.org/wiki/Camel_case
+ *    * https://en.wikipedia.org/wiki/Hungarian_notation
+ *    * http://wiki.c2.com/?UnderscoreVersusCapitalAndLowerCaseVariableNaming
+ *
+ *
+ *
+ * @example
+ *  HelloWorld => helloWorld
+ *  XAxis      => xAxis
+ *  EURange    => euRange
+ *  DATE       => DATE
+ *  XYZ        => XYZ
+ *  AB         => AB
+ *  Ab         => ab
+ *  A          => a
+ *  T1ABC8     => T1ABC8
+ *  F_ABC_D    => F_ABC_D
+ *  ALM_Timeout    => ALM_timeout
+ *  SV_GasOn       => SV_gasOn
+ *  DI_VAL_FlowImp => DI_VAL_flowImp
+ */
+function lowerFirstLetter(str) {
+    if (str == null) {
+        return str;
+    }
+    // at least, 2 all upper
+    if (str.length >= 2 && countUpperCase(str) === countAlpha(str)) {
+        return str;
+    }
+    if (str.match(/_/)) {
+        return str.split("_").map(lowerFirstLetter).join("_");
+    }
+    let result = str.substring(0, 1).toLowerCase() + str.substring(1);
+    if (result.length > 3 && isUpperCaseChar(str[1]) && isUpperCaseChar(str[2])) {
+        result = str.substring(0, 2).toLowerCase() + str.substring(2);
+    }
+    return result;
+}
+exports.lowerFirstLetter = lowerFirstLetter;
+//# sourceMappingURL=string_utils.js.map

package/dist/string_utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string_utils.js","sourceRoot":"","sources":["../source/string_utils.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,+BAA+B;AAC/B,SAAgB,qBAAqB,CAAC,GAAW;IAC7C,IAAI,GAAG,IAAI,IAAI,EAAE;QACb,OAAO,GAAG,CAAC;KACd;IACD,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC;AALD,sDAKC;AAED,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAChC,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAChC,SAAgB,eAAe,CAAC,CAAS;IACrC,MAAM,IAAI,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC7B,OAAO,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC;AAC1C,CAAC;AAHD,0CAGC;AACD,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAChC,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAChC,SAAgB,OAAO,CAAC,CAAS;IAC7B,MAAM,IAAI,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,CAAC;AAChF,CAAC;AAHD,0BAGC;AAED,SAAgB,kBAAkB,CAAC,GAAW;IAC1C,OAAO,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/E,CAAC;AAFD,gDAEC;AACD,SAAgB,cAAc,CAAC,GAAW;IACtC,OAAO,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACvE,CAAC;AAFD,wCAEC;AAED,SAAgB,cAAc,CAAC,GAAW;IACtC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC;IACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE;QACxB,KAAK,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAC5C;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAPD,wCAOC;AACD,SAAgB,UAAU,CAAC,GAAW;IAClC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC;IACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE;QACxB,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KACpC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAPD,gCAOC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,SAAgB,gBAAgB,CAAC,GAAW;IACxC,IAAI,GAAG,IAAI,IAAI,EAAE;QACb,OAAO,GAAG,CAAC;KACd;IACD,wBAAwB;IACxB,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,cAAc,CAAC,GAAG,CAAC,KAAK,UAAU,CAAC,GAAG,CAAC,EAAE;QAC5D,OAAO,GAAG,CAAC;KACd;IAED,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;QAChB,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;KACzD;IACD,IAAI,MAAM,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAClE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE;QACzE,MAAM,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;KACjE;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAjBD,4CAiBC"}

package/dist/timestamp.d.ts

@@ -0,0 +1 @@
+export declare function timestamp(): string;

package/dist/timestamp.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.timestamp = void 0;
+function w(s, length) {
+    return ("" + s).padStart(length, "0");
+}
+function t(d) {
+    return w(d.getUTCHours(), 2) + ":" + w(d.getUTCMinutes(), 2) + ":" + w(d.getUTCSeconds(), 2) + ":" + w(d.getMilliseconds(), 3);
+}
+function timestamp() {
+    return t(new Date());
+}
+exports.timestamp = timestamp;
+//# sourceMappingURL=timestamp.js.map

package/dist/timestamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamp.js","sourceRoot":"","sources":["../source/timestamp.ts"],"names":[],"mappings":";;;AAAA,SAAS,CAAC,CAAC,CAAkB,EAAE,MAAc;IACzC,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,CAAC,CAAC,CAAO;IACd,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,CAAC;AACnI,CAAC;AAED,SAAgB,SAAS;IACrB,OAAO,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;AACzB,CAAC;AAFD,8BAEC"}

package/dist/watchdog.d.ts

@@ -0,0 +1,57 @@
+/// <reference types="node" />
+/**
+ * @module node-opcua-utils
+ */
+import { EventEmitter } from "events";
+type ArbitraryClockTick = number;
+type DurationInMillisecond = number;
+export interface IWatchdogData2 {
+    key: number;
+    subscriber: ISubscriber;
+    timeout: DurationInMillisecond;
+    lastSeen: ArbitraryClockTick;
+    visitCount: number;
+}
+export interface ISubscriber {
+    _watchDog?: WatchDog;
+    _watchDogData?: IWatchdogData2;
+    watchdogReset: () => void;
+    keepAlive?: () => void;
+    onClientSeen?: () => void;
+}
+export declare class WatchDog extends EventEmitter {
+    static lastSeenToDuration(lastSeen: number): number;
+    static emptyKeepAlive: () => void;
+    /**
+     * returns the number of subscribers using the WatchDog object.
+     */
+    get subscriberCount(): number;
+    private readonly _watchdogDataMap;
+    private _counter;
+    private _currentTime;
+    private _timer;
+    private readonly _visitSubscriberB;
+    constructor();
+    /**
+     * add a subscriber to the WatchDog.
+     * @method addSubscriber
+     *
+     * add a subscriber to the WatchDog.
+     *
+     * This method modifies the subscriber be adding a
+     * new method to it called 'keepAlive'
+     * The subscriber must also provide a "watchdogReset". watchdogReset will be called
+     * if the subscriber failed to call keepAlive withing the timeout period.
+     * @param subscriber
+     * @param timeout
+     * @return the numerical key associated with this subscriber
+     */
+    addSubscriber(subscriber: ISubscriber, timeout: number): number;
+    removeSubscriber(subscriber: ISubscriber): void;
+    shutdown(): void;
+    getCurrentSystemTick(): ArbitraryClockTick;
+    private _visit_subscriber;
+    private _start_timer;
+    private _stop_timer;
+}
+export {};

package/dist/watchdog.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WatchDog = void 0;
+/**
+ * @module node-opcua-utils
+ */
+const events_1 = require("events");
+const node_opcua_assert_1 = require("node-opcua-assert");
+const get_clock_tick_1 = require("./get_clock_tick");
+function hasExpired(watchDogData, currentTime) {
+    const elapsedTime = currentTime - watchDogData.lastSeen;
+    return elapsedTime > watchDogData.timeout;
+}
+function keepAliveFunc() {
+    (0, node_opcua_assert_1.assert)(this._watchDog instanceof WatchDog);
+    // istanbul ignore next
+    if (!this._watchDogData || !this._watchDog) {
+        throw new Error("Internal error");
+    }
+    (0, node_opcua_assert_1.assert)(typeof this._watchDogData.key === "number");
+    this._watchDogData.lastSeen = this._watchDog.getCurrentSystemTick();
+    if (this.onClientSeen) {
+        this.onClientSeen();
+    }
+}
+class WatchDog extends events_1.EventEmitter {
+    static lastSeenToDuration(lastSeen) {
+        return (0, get_clock_tick_1.get_clock_tick)() - lastSeen;
+    }
+    /**
+     * returns the number of subscribers using the WatchDog object.
+     */
+    get subscriberCount() {
+        return Object.keys(this._watchdogDataMap).length;
+    }
+    constructor() {
+        super();
+        this._watchdogDataMap = {};
+        this._counter = 0;
+        this._currentTime = this.getCurrentSystemTick();
+        this._visitSubscriberB = this._visit_subscriber.bind(this);
+        this._timer = null; // as NodeJS.Timer;
+    }
+    /**
+     * add a subscriber to the WatchDog.
+     * @method addSubscriber
+     *
+     * add a subscriber to the WatchDog.
+     *
+     * This method modifies the subscriber be adding a
+     * new method to it called 'keepAlive'
+     * The subscriber must also provide a "watchdogReset". watchdogReset will be called
+     * if the subscriber failed to call keepAlive withing the timeout period.
+     * @param subscriber
+     * @param timeout
+     * @return the numerical key associated with this subscriber
+     */
+    addSubscriber(subscriber, timeout) {
+        this._currentTime = this.getCurrentSystemTick();
+        timeout = timeout || 1000;
+        (0, node_opcua_assert_1.assert)(typeof timeout === "number", " invalid timeout ");
+        (0, node_opcua_assert_1.assert)(typeof subscriber.watchdogReset === "function", " the subscriber must provide a watchdogReset method ");
+        (0, node_opcua_assert_1.assert)(typeof subscriber.keepAlive !== "function" || subscriber.keepAlive === WatchDog.emptyKeepAlive);
+        this._counter += 1;
+        const key = this._counter;
+        subscriber._watchDog = this;
+        subscriber._watchDogData = {
+            key,
+            lastSeen: this._currentTime,
+            subscriber,
+            timeout,
+            visitCount: 0
+        };
+        this._watchdogDataMap[key] = subscriber._watchDogData;
+        if (subscriber.onClientSeen) {
+            subscriber.onClientSeen();
+        }
+        subscriber.keepAlive = keepAliveFunc.bind(subscriber);
+        // start timer when the first subscriber comes in
+        if (this.subscriberCount === 1) {
+            (0, node_opcua_assert_1.assert)(this._timer === null);
+            this._start_timer();
+        }
+        (0, node_opcua_assert_1.assert)(this._timer !== null);
+        return key;
+    }
+    removeSubscriber(subscriber) {
+        if (!subscriber._watchDog) {
+            return; // already removed !!!
+        }
+        if (!subscriber._watchDogData) {
+            throw new Error("Internal error");
+        }
+        (0, node_opcua_assert_1.assert)(subscriber._watchDog instanceof WatchDog);
+        (0, node_opcua_assert_1.assert)(typeof subscriber._watchDogData.key === "number");
+        (0, node_opcua_assert_1.assert)(typeof subscriber.keepAlive === "function");
+        (0, node_opcua_assert_1.assert)(Object.prototype.hasOwnProperty.call(this._watchdogDataMap, subscriber._watchDogData.key));
+        delete this._watchdogDataMap[subscriber._watchDogData.key];
+        delete subscriber._watchDog;
+        // leave it as it might be usefull, delete subscriber._watchDogData;
+        subscriber.keepAlive = WatchDog.emptyKeepAlive;
+        // delete timer when the last subscriber comes out
+        if (this.subscriberCount === 0) {
+            this._stop_timer();
+        }
+    }
+    shutdown() {
+        (0, node_opcua_assert_1.assert)(this._timer === null && Object.keys(this._watchdogDataMap).length === 0, " leaking subscriber in watchdog");
+    }
+    getCurrentSystemTick() {
+        return (0, get_clock_tick_1.get_clock_tick)();
+    }
+    _visit_subscriber() {
+        this._currentTime = this.getCurrentSystemTick();
+        const expiredSubscribers = Object.values(this._watchdogDataMap).filter((watchDogData) => {
+            watchDogData.visitCount += 1;
+            return hasExpired(watchDogData, this._currentTime);
+        });
+        if (expiredSubscribers.length) {
+            this.emit("timeout", expiredSubscribers);
+        }
+        expiredSubscribers.forEach((watchDogData) => {
+            this.removeSubscriber(watchDogData.subscriber);
+            watchDogData.subscriber.watchdogReset();
+        });
+    }
+    _start_timer() {
+        (0, node_opcua_assert_1.assert)(this._timer === null, " setInterval already called ?");
+        this._timer = setInterval(this._visitSubscriberB, 1000);
+    }
+    _stop_timer() {
+        (0, node_opcua_assert_1.assert)(this._timer !== null, "_stop_timer already called ?");
+        if (this._timer !== null) {
+            clearInterval(this._timer);
+            this._timer = null;
+        }
+    }
+}
+exports.WatchDog = WatchDog;
+WatchDog.emptyKeepAlive = () => {
+    /* */
+};
+//# sourceMappingURL=watchdog.js.map

package/dist/watchdog.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "node-opcua-utils",
-    "version": "2.98.0",
-    "description": "pure nodejs OPCUA SDK - module -utils",
+    "version": "2.104.0",
+    "description": "pure nodejs OPCUA SDK - module utils",
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",
     "scripts": {
@@ -13,11 +13,11 @@
     },
     "dependencies": {
         "chalk": "4.1.2",
-        "node-opcua-assert": "2.88.0"
+        "node-opcua-assert": "2.104.0"
     },
     "devDependencies": {
         "should": "^13.2.3",
-        "sinon": "^15.0.3"
+        "sinon": "^15.1.0"
     },
     "author": "Etienne Rossignon",
     "license": "MIT",
@@ -34,5 +34,9 @@
         "internet of things"
     ],
     "homepage": "http://node-opcua.github.io/",
-    "gitHead": "e4d73afdfcccb3491423149d9b9785888f4ebb3c"
+    "gitHead": "3cd6d355e8b3c66822d08a3ca682659ea5d1a55d",
+    "files": [
+        "dist",
+        "source"
+    ]
 }

package/source/compare_buffers.ts

@@ -2,7 +2,7 @@
  * @module node-opcua-utils
  */
 // tslint:disable:no-console
-import * as chalk from "chalk";
+import chalk from "chalk";
 import { buffer_ellipsis } from "./buffer_ellipsis";
 
 export function compare_buffers(buf1: Buffer, buf2: Buffer, max_length?: number): void {

package/source/set_deprecated.ts

@@ -2,7 +2,7 @@
  * @module node-opcua-utils
  */
 // tslint:disable:ban-types
-import * as chalk from "chalk";
+import chalk from "chalk";
 import { assert } from "node-opcua-assert";
 
 import { FunctionVariadic } from "./function_variadic";