@blueid/access-cli 0.19.0 → 0.22.0

package/lib/proto/BlueLock_pb.js

@@ -0,0 +1,46 @@
+// @generated by protoc-gen-es v1.4.0 with parameter "target=js+dts"
+// @generated from file BlueLock.proto (syntax proto2)
+/* eslint-disable */
+// @ts-nocheck
+
+import { proto2 } from "@bufbuild/protobuf";
+import { BlueLocalTimeSchedule } from "./BlueCore_pb.js";
+
+/**
+ * @generated from enum BlueLockState
+ */
+export const BlueLockState = proto2.makeEnum(
+  "BlueLockState",
+  [
+    {no: 1, name: "UnknownLockState"},
+    {no: 2, name: "Locked"},
+    {no: 3, name: "Unlocked"},
+    {no: 4, name: "Jammed"},
+  ],
+);
+
+/**
+ * @generated from message BlueLockConfig
+ */
+export const BlueLockConfig = proto2.makeMessageType(
+  "BlueLockConfig",
+  () => [
+    { no: 1, name: "openSchedules", kind: "message", T: BlueLocalTimeSchedule, repeated: true },
+    { no: 2, name: "openScheduleByUser", kind: "scalar", T: 8 /* ScalarType.BOOL */, default: false },
+    { no: 20, name: "closedDays", kind: "scalar", T: 13 /* ScalarType.UINT32 */, repeated: true },
+    { no: 21, name: "defaultOpenTimeSec", kind: "scalar", T: 13 /* ScalarType.UINT32 */, default: 5 },
+    { no: 22, name: "extendedOpenTimeSec", kind: "scalar", T: 13 /* ScalarType.UINT32 */, default: 3600 },
+  ],
+);
+
+/**
+ * @generated from message BlueLockStatus
+ */
+export const BlueLockStatus = proto2.makeMessageType(
+  "BlueLockStatus",
+  () => [
+    { no: 1, name: "state", kind: "enum", T: proto2.getEnumType(BlueLockState) },
+    { no: 2, name: "openings", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+  ],
+);
+

package/lib/proto/BlueSDK_pb.js

@@ -0,0 +1,73 @@
+// @generated by protoc-gen-es v1.4.0 with parameter "target=js+dts"
+// @generated from file BlueSDK.proto (syntax proto2)
+/* eslint-disable */
+// @ts-nocheck
+
+import { proto2 } from "@bufbuild/protobuf";
+import { BlueBleManufacturerInfo } from "./BlueCore_pb.js";
+
+/**
+ * @generated from enum BlueDeviceType
+ */
+export const BlueDeviceType = proto2.makeEnum(
+  "BlueDeviceType",
+  [
+    {no: 1, name: "BluetoothDevice"},
+    {no: 2, name: "UWBDevice"},
+  ],
+);
+
+/**
+ * @generated from message BlueI18n
+ */
+export const BlueI18n = proto2.makeMessageType(
+  "BlueI18n",
+  () => [
+    { no: 1, name: "nfcWaitMessage", kind: "scalar", T: 9 /* ScalarType.STRING */, default: "Waiting for transponder" },
+    { no: 2, name: "nfcOssSuccessReadConfigurationMessage", kind: "scalar", T: 9 /* ScalarType.STRING */, default: "Configuration read successfully" },
+    { no: 3, name: "nfcOssSuccessUpdateConfigurationMessage", kind: "scalar", T: 9 /* ScalarType.STRING */, default: "Configuration successfully updated" },
+    { no: 4, name: "nfcOssSuccessClearEventsMessage", kind: "scalar", T: 9 /* ScalarType.STRING */, default: "Events successfully cleared" },
+    { no: 5, name: "nfcOssSuccessIsProvisionedMessage", kind: "scalar", T: 9 /* ScalarType.STRING */, default: "Is already provisioned" },
+    { no: 6, name: "nfcOssSuccessProvisionMessage", kind: "scalar", T: 9 /* ScalarType.STRING */, default: "Successfully provisioned" },
+    { no: 7, name: "nfcOssSuccessUnprovisionMessage", kind: "scalar", T: 9 /* ScalarType.STRING */, default: "Successfully unprovisioned" },
+    { no: 8, name: "nfcOssSuccessFormatMessage", kind: "scalar", T: 9 /* ScalarType.STRING */, default: "Transponder was successfully formatted" },
+  ],
+);
+
+/**
+ * @generated from message BlueDeviceDetailsBluetooth
+ */
+export const BlueDeviceDetailsBluetooth = proto2.makeMessageType(
+  "BlueDeviceDetailsBluetooth",
+  () => [
+    { no: 1, name: "rssi", kind: "scalar", T: 5 /* ScalarType.INT32 */ },
+    { no: 2, name: "txPower", kind: "scalar", T: 5 /* ScalarType.INT32 */ },
+    { no: 3, name: "isIBeacon", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
+  ],
+);
+
+/**
+ * @generated from message BlueDeviceDetailsUWB
+ */
+export const BlueDeviceDetailsUWB = proto2.makeMessageType(
+  "BlueDeviceDetailsUWB",
+  () => [
+    { no: 1, name: "notUsed", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
+  ],
+);
+
+/**
+ * @generated from message BlueDeviceInfo
+ */
+export const BlueDeviceInfo = proto2.makeMessageType(
+  "BlueDeviceInfo",
+  () => [
+    { no: 1, name: "deviceType", kind: "enum", T: proto2.getEnumType(BlueDeviceType) },
+    { no: 2, name: "deviceId", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 3, name: "distanceMeters", kind: "scalar", T: 2 /* ScalarType.FLOAT */ },
+    { no: 4, name: "manufacturerInfo", kind: "message", T: BlueBleManufacturerInfo, opt: true },
+    { no: 5, name: "bluetooth", kind: "message", T: BlueDeviceDetailsBluetooth, oneof: "details" },
+    { no: 6, name: "uwb", kind: "message", T: BlueDeviceDetailsUWB, oneof: "details" },
+  ],
+);
+

package/lib/proto/BlueSystem_pb.js

@@ -0,0 +1,260 @@
+// @generated by protoc-gen-es v1.4.0 with parameter "target=js+dts"
+// @generated from file BlueSystem.proto (syntax proto2)
+/* eslint-disable */
+// @ts-nocheck
+
+import { proto2 } from "@bufbuild/protobuf";
+import { BlueBatteryLevel, BlueBlacklistEntry, BlueEvent, BlueHardwareType, BlueLocalTimeSchedule, BlueLocalTimestamp } from "./BlueCore_pb.js";
+import { BlueLockConfig, BlueLockStatus } from "./BlueLock_pb.js";
+
+/**
+ * @generated from message BlueBaseConfig
+ */
+export const BlueBaseConfig = proto2.makeMessageType(
+  "BlueBaseConfig",
+  () => [
+    { no: 1, name: "isoCountry", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 2, name: "isoState", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 3, name: "utcOffsetMinutes", kind: "scalar", T: 5 /* ScalarType.INT32 */, default: 0 },
+    { no: 4, name: "autoCheckSystemStatus", kind: "scalar", T: 8 /* ScalarType.BOOL */, default: false },
+  ],
+);
+
+/**
+ * @generated from message BlueBleConfig
+ */
+export const BlueBleConfig = proto2.makeMessageType(
+  "BlueBleConfig",
+  () => [
+    { no: 1, name: "isAdvertising", kind: "scalar", T: 8 /* ScalarType.BOOL */, default: true },
+    { no: 2, name: "advertisingSchedules", kind: "message", T: BlueLocalTimeSchedule, repeated: true },
+    { no: 3, name: "maxPowerAdvertisingSchedulesIndices", kind: "scalar", T: 13 /* ScalarType.UINT32 */, repeated: true },
+    { no: 4, name: "advertisingIntervalMs", kind: "scalar", T: 13 /* ScalarType.UINT32 */, default: 500 },
+    { no: 5, name: "maxConnectionTimeoutMs", kind: "scalar", T: 13 /* ScalarType.UINT32 */, default: 3000 },
+    { no: 6, name: "txPowerLevel", kind: "scalar", T: 13 /* ScalarType.UINT32 */, default: 3 },
+    { no: 7, name: "advertisedTxPower1Meter", kind: "scalar", T: 5 /* ScalarType.INT32 */, default: -77 },
+    { no: 8, name: "isIBeaconAdvertisement", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
+  ],
+);
+
+/**
+ * @generated from message BlueOnlineConfig
+ */
+export const BlueOnlineConfig = proto2.makeMessageType(
+  "BlueOnlineConfig",
+  () => [
+    { no: 1, name: "connectSchedules", kind: "message", T: BlueLocalTimeSchedule, repeated: true },
+    { no: 2, name: "wifiSSID", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 3, name: "wifiPassword", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 4, name: "timeoutSec", kind: "scalar", T: 13 /* ScalarType.UINT32 */, default: 30 },
+  ],
+);
+
+/**
+ * @generated from message BlueAccessConfigGroup
+ */
+export const BlueAccessConfigGroup = proto2.makeMessageType(
+  "BlueAccessConfigGroup",
+  () => [
+    { no: 1, name: "groupId", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 2, name: "schedules", kind: "message", T: BlueLocalTimeSchedule, repeated: true },
+  ],
+);
+
+/**
+ * @generated from message BlueAccessConfig
+ */
+export const BlueAccessConfig = proto2.makeMessageType(
+  "BlueAccessConfig",
+  () => [
+    { no: 1, name: "id", kind: "scalar", T: 13 /* ScalarType.UINT32 */, default: 1 },
+    { no: 2, name: "siteId", kind: "scalar", T: 13 /* ScalarType.UINT32 */, default: 1 },
+    { no: 3, name: "groups", kind: "message", T: BlueAccessConfigGroup, repeated: true },
+  ],
+);
+
+/**
+ *
+ * -- Oss SecureId --
+ *
+ *
+ * @generated from message BlueOssConfig
+ */
+export const BlueOssConfig = proto2.makeMessageType(
+  "BlueOssConfig",
+  () => [
+    { no: 1, name: "sidMifareAesKey", kind: "scalar", T: 12 /* ScalarType.BYTES */, default: new Uint8Array([0xFF, 0xEE, 0xDD, 0xCC, 0xBB, 0xAA, 0x99, 0x88, 0x77, 0x66, 0x55, 0x44, 0x33, 0x11, 0x00]) },
+    { no: 2, name: "sidMifareAid", kind: "scalar", T: 13 /* ScalarType.UINT32 */, default: 16076801 },
+    { no: 3, name: "soUpdater", kind: "scalar", T: 8 /* ScalarType.BOOL */, default: false },
+    { no: 4, name: "soPushEvents", kind: "scalar", T: 8 /* ScalarType.BOOL */, default: false },
+    { no: 5, name: "soWritePendingEvents", kind: "scalar", T: 8 /* ScalarType.BOOL */, default: true },
+    { no: 6, name: "soUpdateFromBlacklist", kind: "scalar", T: 8 /* ScalarType.BOOL */, default: true },
+    { no: 7, name: "soMifareAesKey", kind: "scalar", T: 12 /* ScalarType.BYTES */, default: new Uint8Array([0x10, 0x11, 0x12, 0x13, 0x14, 0x15, 0x16, 0x17, 0x18, 0x19, 0x1A, 0x1B, 0x1C, 0x1D, 0x1E, 0x1F]) },
+    { no: 8, name: "soMifareAid", kind: "scalar", T: 13 /* ScalarType.UINT32 */, default: 16076800 },
+  ],
+);
+
+/**
+ * @generated from message BlueSystemConfig
+ */
+export const BlueSystemConfig = proto2.makeMessageType(
+  "BlueSystemConfig",
+  () => [
+    { no: 1, name: "configId", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 2, name: "base", kind: "message", T: BlueBaseConfig },
+    { no: 3, name: "ble", kind: "message", T: BlueBleConfig },
+    { no: 4, name: "online", kind: "message", T: BlueOnlineConfig },
+    { no: 5, name: "access", kind: "message", T: BlueAccessConfig },
+    { no: 6, name: "oss", kind: "message", T: BlueOssConfig },
+    { no: 7, name: "lock", kind: "message", T: BlueLockConfig, opt: true },
+  ],
+);
+
+/**
+ * @generated from message BlueSystemTimeUnix
+ */
+export const BlueSystemTimeUnix = proto2.makeMessageType(
+  "BlueSystemTimeUnix",
+  () => [
+    { no: 1, name: "epoch", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+  ],
+);
+
+/**
+ * @generated from message BlueSystemUpdate
+ */
+export const BlueSystemUpdate = proto2.makeMessageType(
+  "BlueSystemUpdate",
+  () => [
+    { no: 1, name: "config", kind: "message", T: BlueSystemConfig, opt: true },
+    { no: 2, name: "timeUnix", kind: "message", T: BlueSystemTimeUnix, opt: true },
+  ],
+);
+
+/**
+ * @generated from message BlueSystemSettings
+ */
+export const BlueSystemSettings = proto2.makeMessageType(
+  "BlueSystemSettings",
+  () => [
+    { no: 1, name: "blacklistMaxEntriesCount", kind: "scalar", T: 13 /* ScalarType.UINT32 */, default: 0 },
+    { no: 2, name: "blacklistEntriesCount", kind: "scalar", T: 13 /* ScalarType.UINT32 */, default: 0 },
+    { no: 3, name: "eventLogMaxEntriesCount", kind: "scalar", T: 13 /* ScalarType.UINT32 */, default: 0 },
+    { no: 4, name: "eventLogEntriesCount", kind: "scalar", T: 13 /* ScalarType.UINT32 */, default: 0 },
+    { no: 5, name: "eventLogSequenceId", kind: "scalar", T: 13 /* ScalarType.UINT32 */, default: 0 },
+    { no: 6, name: "eventLogIndex", kind: "scalar", T: 13 /* ScalarType.UINT32 */, default: 0 },
+    { no: 7, name: "systemLogMaxEntriesCount", kind: "scalar", T: 13 /* ScalarType.UINT32 */, default: 0 },
+    { no: 8, name: "systemLogEntriesCount", kind: "scalar", T: 13 /* ScalarType.UINT32 */, default: 0 },
+    { no: 9, name: "systemLogSequenceId", kind: "scalar", T: 13 /* ScalarType.UINT32 */, default: 0 },
+    { no: 10, name: "systemLogIndex", kind: "scalar", T: 13 /* ScalarType.UINT32 */, default: 0 },
+    { no: 11, name: "timeWasSet", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
+    { no: 12, name: "isBatteryLow", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
+  ],
+);
+
+/**
+ * @generated from message BlueSystemProvisioning
+ */
+export const BlueSystemProvisioning = proto2.makeMessageType(
+  "BlueSystemProvisioning",
+  () => [
+    { no: 1, name: "hardwareType", kind: "enum", T: proto2.getEnumType(BlueHardwareType), default: BlueHardwareType.TestHardware },
+    { no: 2, name: "deviceId", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 3, name: "serialNumber", kind: "scalar", T: 9 /* ScalarType.STRING */, default: "00000000000000000000" },
+    { no: 4, name: "terminalPrivateKey", kind: "scalar", T: 12 /* ScalarType.BYTES */ },
+    { no: 5, name: "signaturePublicKey", kind: "scalar", T: 12 /* ScalarType.BYTES */ },
+  ],
+);
+
+/**
+ * @generated from message BlueSystemStatus
+ */
+export const BlueSystemStatus = proto2.makeMessageType(
+  "BlueSystemStatus",
+  () => [
+    { no: 1, name: "configId", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 2, name: "deviceId", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 3, name: "serialNumber", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 4, name: "hardwareType", kind: "enum", T: proto2.getEnumType(BlueHardwareType) },
+    { no: 5, name: "batteryLevel", kind: "enum", T: proto2.getEnumType(BlueBatteryLevel) },
+    { no: 6, name: "applicationVersion", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 7, name: "localTime", kind: "message", T: BlueLocalTimestamp },
+    { no: 8, name: "settings", kind: "message", T: BlueSystemSettings },
+    { no: 9, name: "blacklistEntriesCount", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 10, name: "eventLogEntriesCount", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 11, name: "eventLogSequenceId", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 12, name: "systemLogEntriesCount", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 13, name: "systemLogSequenceId", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 14, name: "lock", kind: "message", T: BlueLockStatus, opt: true },
+  ],
+);
+
+/**
+ * @generated from message BlueSystemLogQuery
+ */
+export const BlueSystemLogQuery = proto2.makeMessageType(
+  "BlueSystemLogQuery",
+  () => [
+    { no: 1, name: "maxCount", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 2, name: "sequenceId", kind: "scalar", T: 13 /* ScalarType.UINT32 */, oneof: "start" },
+    { no: 3, name: "fromHead", kind: "scalar", T: 8 /* ScalarType.BOOL */, oneof: "start" },
+  ],
+);
+
+/**
+ * @generated from message BlueSystemLogEntry
+ */
+export const BlueSystemLogEntry = proto2.makeMessageType(
+  "BlueSystemLogEntry",
+  () => [
+    { no: 1, name: "sequenceId", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 2, name: "time", kind: "message", T: BlueLocalTimestamp },
+    { no: 3, name: "severity", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 4, name: "line", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 5, name: "file", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 6, name: "message", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+  ],
+);
+
+/**
+ * @generated from message BlueSystemLogResult
+ */
+export const BlueSystemLogResult = proto2.makeMessageType(
+  "BlueSystemLogResult",
+  () => [
+    { no: 1, name: "entries", kind: "message", T: BlueSystemLogEntry, repeated: true },
+  ],
+);
+
+/**
+ * @generated from message BlueEventLogQuery
+ */
+export const BlueEventLogQuery = proto2.makeMessageType(
+  "BlueEventLogQuery",
+  () => [
+    { no: 1, name: "maxCount", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 2, name: "sequenceId", kind: "scalar", T: 13 /* ScalarType.UINT32 */, oneof: "start" },
+    { no: 3, name: "fromHead", kind: "scalar", T: 8 /* ScalarType.BOOL */, oneof: "start" },
+  ],
+);
+
+/**
+ * @generated from message BlueEventLogResult
+ */
+export const BlueEventLogResult = proto2.makeMessageType(
+  "BlueEventLogResult",
+  () => [
+    { no: 1, name: "events", kind: "message", T: BlueEvent, repeated: true },
+  ],
+);
+
+/**
+ * @generated from message BlueBlacklistEntries
+ */
+export const BlueBlacklistEntries = proto2.makeMessageType(
+  "BlueBlacklistEntries",
+  () => [
+    { no: 1, name: "entries", kind: "message", T: BlueBlacklistEntry, repeated: true },
+  ],
+);
+

package/lib/shared/binaryToIntelHex.js

@@ -0,0 +1,246 @@
+// From https://en.wikipedia.org/wiki/Intel_HEX
+//
+//		Intel Hex Line Format (I32HEX, 32 bit addresses) is
+//          :llaaaatt[dd...]cc
+//		Where
+//          ll=data length
+//		    aaaa=lower 16 bit address
+//		    tt=record type
+//			    00 - data record
+//              01 - end-of-file record
+//              02 - extended segment address record (Not used in I32Hex)
+//              04 - extended linear address record
+//              05 - start linear address record (MDK-ARM only)
+//		    cc=checksum = 2's comp of negative of sum of all record bytes
+
+var DEFAULT_LINE_TERMINATOR = '\n'
+var SEGMENT_LENGTH_BYTES = 0x10000
+var MAX_BASE_ADDRESS = 0xffff
+
+const utils = {
+    numberToHexString: function (d, padding) {
+        var hex = Number(d).toString(16).toUpperCase()
+        padding = typeof padding === 'undefined' || padding === null ? (padding = 8) : padding
+
+        while (hex.length < padding) {
+            hex = '0' + hex
+        }
+
+        return hex
+    },
+    numberToHexStringLittleEndian: function (d, padding) {
+        if (padding % 2 != 0)
+            throw new Error('numberToHexStringLittleEndian requires an even padding [' + padding + ']')
+
+        var bigEndianHex = utils.numberToHexString(d, padding)
+
+        var littleEndianHex = ''
+        while (bigEndianHex.length) {
+            var nibble = bigEndianHex[0] + bigEndianHex[1]
+            bigEndianHex = bigEndianHex.slice(2)
+            littleEndianHex = nibble + littleEndianHex
+        }
+
+        return littleEndianHex
+    },
+    hexStringByWords: function (hex, littleEndian) {
+        if (!hex || hex.length % 8 !== 0) throw new Error('hexStringByWords requires a word-aligned hex string')
+        littleEndian = !!littleEndian
+
+        hex = hex.toUpperCase()
+        const wordStrings = []
+
+        for (var i = 0; i < hex.length; i += 8) {
+            var ws = hex.substring(i, i + 8)
+            if (littleEndian) {
+                ws = ws.substring(6, 8) + ws.substring(4, 6) + ws.substring(2, 4) + ws.substring(0, 2)
+            }
+            wordStrings.push(ws)
+        }
+
+        return wordStrings.join(' ')
+    },
+    hexToDecimal: function (hexString) {
+        try {
+            return parseInt(hexString, 16)
+        } catch (e) {
+            console.error('Error parsing hexString: ', e)
+            return 0
+        }
+    },
+    toUInt32: function (val) {
+        return val >>> 0
+    },
+}
+
+function IntelHexFileOut(startAddress) {
+    if (startAddress === void 0) startAddress = 0
+
+    this.contents = ''
+    this.extendedAddress = 0
+    this.relativeAddress = 0
+    this.lastAppendEndedAtBoundary = false
+    this.lineTerminator = DEFAULT_LINE_TERMINATOR
+
+    this.setAddress(startAddress)
+}
+
+IntelHexFileOut.withIntelHex = function (initialHexString, startAddress) {
+    const intelhexProcessor = new IntelHexFileOut(startAddress)
+    intelhexProcessor.contents = initialHexString.toUpperCase()
+    intelhexProcessor.reopen()
+    return intelhexProcessor
+}
+
+IntelHexFileOut.prototype.reopen = function () {
+    const indexOfTerminator = this.contents.indexOf(this.eofMarker())
+    if (indexOfTerminator !== -1) {
+        this.contents = this.contents.substring(0, indexOfTerminator)
+    }
+}
+
+IntelHexFileOut.prototype.eofMarker = function () {
+    return ':00000001FF' + this.lineTerminator
+}
+
+IntelHexFileOut.prototype.setAddress = function (address) {
+    var extendedAddress = this._extendedAddressFromAddress(address)
+    this.relativeAddress = this._addressRelativeToExtendedAddress(address, extendedAddress)
+
+    if (this.extendedAddress === extendedAddress) return
+    this.extendedAddress = extendedAddress
+
+    this._writeExtendedAddress()
+
+    this.lastAppendEndedAtBoundary = false
+}
+
+IntelHexFileOut.prototype.writeHexStringAtAddress = function (address, hexString) {
+    if (!hexString || hexString.length === 0 || hexString.length > SEGMENT_LENGTH_BYTES || hexString.length % 2 !== 0) {
+        throw new Error('invalid length of hexString [' + hexString.length + ']')
+    }
+
+    this.setAddress(address)
+    this.appendHexString(hexString)
+}
+
+IntelHexFileOut.prototype.appendBuffer = function (buffer, littleEndian) {
+    if (!buffer) throw new Error('Buffer required')
+    if (buffer.length % 4 !== 0) throw new Error('Buffer length not 32 bit word aligned')
+
+    const words = []
+    for (var offset = 0; offset < buffer.length; offset += 4) {
+        const uint32 = littleEndian ? buffer.readUInt32LE(offset) : buffer.readUInt32BE(offset)
+        words.push(uint32)
+    }
+
+    this.appendWords(words, littleEndian)
+}
+
+IntelHexFileOut.prototype.appendWords = function (words, littleEndian) {
+    if (!words || words.length === 0) {
+        // || words.length * 4 > SEGMENT_LENGTH_BYTES ){
+        throw new Error('invalid number of words [' + words.length + ']')
+    }
+
+    var encodeAsString = littleEndian ? utils.numberToHexStringLittleEndian : utils.numberToHexString
+
+    var lineHexString = ''
+    while (words.length) {
+        lineHexString += encodeAsString(words.shift(), 8)
+        if (lineHexString.length === 32) {
+            this.appendHexString(lineHexString)
+            lineHexString = ''
+        }
+    }
+
+    if (lineHexString.length) {
+        this.appendHexString(lineHexString)
+    }
+}
+
+IntelHexFileOut.prototype.appendHexString = function (hexString) {
+    if (!hexString || hexString.length === 0 || hexString.length > SEGMENT_LENGTH_BYTES || hexString.length % 2 !== 0) {
+        throw new Error('invalid length of hexString [' + hexString.length + ']')
+    }
+
+    while (hexString.length) {
+        var lineHexCharLength = hexString.length < 32 ? hexString.length : 32
+        var lineHexString = hexString.slice(0, lineHexCharLength)
+
+        hexString = hexString.slice(lineHexCharLength)
+
+        this._handleBlockContinuation()
+
+        var byteCount = lineHexString.length / 2
+
+        if (this.relativeAddress + byteCount > 0x10000) {
+            throw new Error('appendHexString cannot write across 63336 byte boundary')
+        }
+
+        this._writeHexString(lineHexString)
+
+        this.relativeAddress += byteCount
+        if (this.relativeAddress == SEGMENT_LENGTH_BYTES) {
+            this.extendedAddress += 0x0001
+            this.relativeAddress = 0x0000
+            this.lastAppendEndedAtBoundary = true
+        }
+    }
+}
+
+IntelHexFileOut.prototype.close = function () {
+    this.contents += this.eofMarker()
+}
+
+IntelHexFileOut.prototype._writeExtendedAddress = function () {
+    var data = this.extendedAddress
+    var intelHex = '02' + '0000' + '04' + utils.numberToHexString(data, 4)
+    intelHex += this._crc(intelHex)
+    this.contents += ':' + intelHex + this.lineTerminator
+}
+
+IntelHexFileOut.prototype._writeHexString = function (hexString) {
+    var byteCount = hexString.length / 2
+    var intelHex =
+        utils.numberToHexString(byteCount, 2) + utils.numberToHexString(this.relativeAddress, 4) + '00' + hexString
+    intelHex += this._crc(intelHex)
+    this.contents += ':' + intelHex + this.lineTerminator
+}
+
+IntelHexFileOut.prototype._handleBlockContinuation = function () {
+    if (this.lastAppendEndedAtBoundary) {
+        this._writeExtendedAddress()
+        this.lastAppendEndedAtBoundary = false
+    }
+}
+
+IntelHexFileOut.prototype._crc = function (intelHexString) {
+    var sum = 0
+    for (var i = 0; i < intelHexString.length; i += 2) {
+        var byteHexString = intelHexString.charAt(i) + intelHexString.charAt(i + 1)
+        sum += utils.hexToDecimal(byteHexString) & 0xff
+    }
+    var crc = ((sum ^ 0xff) + 1) & 0xff
+    return utils.numberToHexString(crc, 2)
+}
+
+IntelHexFileOut.prototype._extendedAddressFromAddress = function (address) {
+    return address >>> 16
+}
+
+IntelHexFileOut.prototype._addressRelativeToExtendedAddress = function (address, extendedAddress) {
+    var baseAddress = utils.toUInt32(extendedAddress << 16)
+    if (address < baseAddress || address - baseAddress > MAX_BASE_ADDRESS) {
+        throw new Error('address must be 0 to 65535 bytes above baseAddress [' + baseAddress + ']')
+    }
+
+    return address - baseAddress
+}
+
+export default (startAddress, littleEndian, buffer) => {
+    var processor = new IntelHexFileOut(startAddress)
+    processor.appendBuffer(buffer, littleEndian)
+    processor.close()
+    return processor.contents
+}

package/lib/shared/crc16.js

@@ -0,0 +1,26 @@
+const STORAGE_CRC_16_MAGIC_NUMBER = 0x92db
+
+export default (buffer, start, magicMarker = false) => {
+    // CRC-16-CCITT (XModem)
+    const crcTable = [
+        0x0000, 0x1021, 0x2042, 0x3063, 0x4084, 0x50a5, 0x60c6, 0x70e7, 0x8108, 0x9129, 0xa14a, 0xb16b, 0xc18c, 0xd1ad,
+        0xe1ce, 0xf1ef,
+    ]
+
+    let crc = 0xffff
+
+    const data = new Uint8Array(buffer)
+
+    for (let i = start; i < data.length; i++) {
+        crc = (crc << 4) ^ crcTable[((crc >>> 12) ^ data[i]) & 0x0f]
+        crc = (crc << 4) ^ crcTable[((crc >>> 12) ^ (data[i] >>> 4)) & 0x0f]
+    }
+
+    if (magicMarker) {
+        crc ^= STORAGE_CRC_16_MAGIC_NUMBER
+    }
+
+    crc &= 0xffff
+
+    return crc
+}