@springfield/ham-radio-utils 2.2.1 → 3.0.0

package/CHANGELOG.md

@@ -1,3 +1,21 @@
+## [3.0.0](https://gitlab.com/springfield-ham-radio/app/ham-radio-utils/compare/v2.2.2...v3.0.0) (2025-08-17)
+
+
+### ⚠ BREAKING CHANGES
+
+* update .oxlintrc.json and package.json for linting improvements and dependency upgrades
+
+### Features
+
+* update .oxlintrc.json and package.json for linting improvements and dependency upgrades ([119f934](https://gitlab.com/springfield-ham-radio/app/ham-radio-utils/commit/119f934550846d86d034bce30d735463dcabe4eb))
+
+## [2.2.2](https://gitlab.com/springfield-ham-radio/app/ham-radio-utils/compare/v2.2.1...v2.2.2) (2025-08-08)
+
+
+### Bug Fixes
+
+* **deps:** update dependency @springfield/ham-radio-api to ^16.1.2 ([5e45772](https://gitlab.com/springfield-ham-radio/app/ham-radio-utils/commit/5e4577239236c3a32e43ce6c8dbbf6c75ab73196))
+
 ## [2.2.1](https://gitlab.com/springfield-ham-radio/app/ham-radio-utils/compare/v2.2.0...v2.2.1) (2025-07-11)
 
 

package/dist/index.d.ts

@@ -1,12 +1,10 @@
 export * from './memory/segmented-memory.js';
 export * from './test-utils/radio-channel-factory.js';
 export * from './test-utils/radio-programmed-channel-factory.js';
-export * from './utils/bcd-to-number.js';
 export * from './utils/band-plan.js';
 export * from './utils/frequency-display.js';
 export * from './utils/memory-channel-utils.js';
 export * from './utils/memory-data-utils.js';
-export * from './utils/number-to-bcd.js';
 export * from './utils/schema-validator.js';
 export * from './utils/to-hex-words.js';
 export * from './utils/ui-logger.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAE7C,cAAc,uCAAuC,CAAC;AACtD,cAAc,kDAAkD,CAAC;AAEjE,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAG7C,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,sCAAsC,CAAuB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAE7C,cAAc,uCAAuC,CAAC;AACtD,cAAc,kDAAkD,CAAC;AAEjE,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAG7C,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,sCAAsC,CAAuB"}

package/dist/index.js

@@ -1,12 +1,10 @@
 export * from './memory/segmented-memory.js';
 export * from './test-utils/radio-channel-factory.js';
 export * from './test-utils/radio-programmed-channel-factory.js';
-export * from './utils/bcd-to-number.js';
 export * from './utils/band-plan.js';
 export * from './utils/frequency-display.js';
 export * from './utils/memory-channel-utils.js';
 export * from './utils/memory-data-utils.js';
-export * from './utils/number-to-bcd.js';
 export * from './utils/schema-validator.js';
 export * from './utils/to-hex-words.js';
 export * from './utils/ui-logger.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAE7C,cAAc,uCAAuC,CAAC;AACtD,cAAc,kDAAkD,CAAC;AAEjE,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAE7C,mCAAmC;AACnC,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,sCAAsC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC","sourcesContent":["export * from './memory/segmented-memory.js';\n\nexport * from './test-utils/radio-channel-factory.js';\nexport * from './test-utils/radio-programmed-channel-factory.js';\n\nexport * from './utils/bcd-to-number.js';\nexport * from './utils/band-plan.js';\nexport * from './utils/frequency-display.js';\nexport * from './utils/memory-channel-utils.js';\nexport * from './utils/memory-data-utils.js';\nexport * from './utils/number-to-bcd.js';\nexport * from './utils/schema-validator.js';\nexport * from './utils/to-hex-words.js';\nexport * from './utils/ui-logger.js';\nexport * from './utils/ui-logger-factory.js';\n\n// Export the radio protocol schema\nexport { default as radioProtocolSchema } from './schemas/radio-protocol-schema.json' with { type: 'json' };\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAE7C,cAAc,uCAAuC,CAAC;AACtD,cAAc,kDAAkD,CAAC;AAEjE,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAE7C,mCAAmC;AACnC,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,sCAAsC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC","sourcesContent":["export * from './memory/segmented-memory.js';\n\nexport * from './test-utils/radio-channel-factory.js';\nexport * from './test-utils/radio-programmed-channel-factory.js';\n\nexport * from './utils/band-plan.js';\nexport * from './utils/frequency-display.js';\nexport * from './utils/memory-channel-utils.js';\nexport * from './utils/memory-data-utils.js';\nexport * from './utils/schema-validator.js';\nexport * from './utils/to-hex-words.js';\nexport * from './utils/ui-logger.js';\nexport * from './utils/ui-logger-factory.js';\n\n// Export the radio protocol schema\nexport { default as radioProtocolSchema } from './schemas/radio-protocol-schema.json' with { type: 'json' };\n"]}

package/dist/memory/segmented-memory.js

@@ -2,7 +2,7 @@ export class RadioSegmentedMemory {
     segments;
     constructor(segments) {
         this.segments = new Map();
-        if (segments != undefined) {
+        if (segments) {
             for (const segment of segments) {
                 this.segments.set(segment.startAddress, segment);
             }
@@ -30,7 +30,7 @@ export class RadioSegmentedMemory {
             }
             result = iterator.next();
         }
-        return undefined;
+        return {};
     }
     toArray() {
         return [...this.segments.values()];

package/dist/memory/segmented-memory.js.map

@@ -1 +1 @@
-{"version":3,"file":"segmented-memory.js","sourceRoot":"","sources":["../../src/memory/segmented-memory.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,oBAAoB;IACvB,QAAQ,CAAkC;IAElD,YAAY,QAA+B;QACzC,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;QAE1B,IAAI,QAAQ,IAAI,SAAS,EAAE,CAAC;YAC1B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;IACH,CAAC;IAEM,UAAU,CAAC,OAA2B;QAC3C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAEM,WAAW;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;IAChC,CAAC;IAEM,UAAU,CAAC,YAAoB;QACpC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACzC,CAAC;IAEM,YAAY;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;IAEM,WAAW,CAAC,OAAe;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACxC,IAAI,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAE7B,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC;YAE7B,IAAI,OAAO,CAAC,YAAY,IAAI,OAAO,IAAI,OAAO,CAAC,UAAU,GAAG,OAAO,EAAE,CAAC;gBACpE,OAAO,OAAO,CAAC;YACjB,CAAC;YAED,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC3B,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAEM,OAAO;QACZ,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,CAAC;CACF","sourcesContent":["import type { RadioMemorySegment } from '@springfield/ham-radio-api';\n\nexport class RadioSegmentedMemory {\n  private segments: Map<number, RadioMemorySegment>;\n\n  constructor(segments?: RadioMemorySegment[]) {\n    this.segments = new Map();\n\n    if (segments != undefined) {\n      for (const segment of segments) {\n        this.segments.set(segment.startAddress, segment);\n      }\n    }\n  }\n\n  public addSegment(segment: RadioMemorySegment): void {\n    this.segments.set(segment.startAddress, segment);\n  }\n\n  public getSegments(): IterableIterator<RadioMemorySegment> {\n    return this.segments.values();\n  }\n\n  public getSegment(startAddress: number): RadioMemorySegment | undefined {\n    return this.segments.get(startAddress);\n  }\n\n  public segmentCount(): number {\n    return this.segments.size;\n  }\n\n  public findSegment(address: number): RadioMemorySegment | undefined {\n    const iterator = this.segments.values();\n    let result = iterator.next();\n\n    while (!result.done) {\n      const segment = result.value;\n\n      if (segment.startAddress <= address && segment.endAddress > address) {\n        return segment;\n      }\n\n      result = iterator.next();\n    }\n\n    return undefined;\n  }\n\n  public toArray(): RadioMemorySegment[] {\n    return [...this.segments.values()];\n  }\n}\n"]}
+{"version":3,"file":"segmented-memory.js","sourceRoot":"","sources":["../../src/memory/segmented-memory.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,oBAAoB;IACvB,QAAQ,CAAkC;IAElD,YAAY,QAA+B;QACzC,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;QAE1B,IAAI,QAAQ,EAAE,CAAC;YACb,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;IACH,CAAC;IAEM,UAAU,CAAC,OAA2B;QAC3C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAEM,WAAW;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;IAChC,CAAC;IAEM,UAAU,CAAC,YAAoB;QACpC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACzC,CAAC;IAEM,YAAY;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;IAEM,WAAW,CAAC,OAAe;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACxC,IAAI,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAE7B,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC;YAE7B,IAAI,OAAO,CAAC,YAAY,IAAI,OAAO,IAAI,OAAO,CAAC,UAAU,GAAG,OAAO,EAAE,CAAC;gBACpE,OAAO,OAAO,CAAC;YACjB,CAAC;YAED,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC3B,CAAC;QAED,OAAO,EAAwB,CAAC;IAClC,CAAC;IAEM,OAAO;QACZ,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,CAAC;CACF","sourcesContent":["import type { RadioMemorySegment } from '@springfield/ham-radio-api';\n\nexport class RadioSegmentedMemory {\n  private segments: Map<number, RadioMemorySegment>;\n\n  constructor(segments?: RadioMemorySegment[]) {\n    this.segments = new Map();\n\n    if (segments) {\n      for (const segment of segments) {\n        this.segments.set(segment.startAddress, segment);\n      }\n    }\n  }\n\n  public addSegment(segment: RadioMemorySegment): void {\n    this.segments.set(segment.startAddress, segment);\n  }\n\n  public getSegments(): IterableIterator<RadioMemorySegment> {\n    return this.segments.values();\n  }\n\n  public getSegment(startAddress: number): RadioMemorySegment | undefined {\n    return this.segments.get(startAddress);\n  }\n\n  public segmentCount(): number {\n    return this.segments.size;\n  }\n\n  public findSegment(address: number): RadioMemorySegment | undefined {\n    const iterator = this.segments.values();\n    let result = iterator.next();\n\n    while (!result.done) {\n      const segment = result.value;\n\n      if (segment.startAddress <= address && segment.endAddress > address) {\n        return segment;\n      }\n\n      result = iterator.next();\n    }\n\n    return {} as RadioMemorySegment;\n  }\n\n  public toArray(): RadioMemorySegment[] {\n    return [...this.segments.values()];\n  }\n}\n"]}

package/dist/utils/memory-channel-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-channel-utils.d.ts","sourceRoot":"","sources":["../../src/utils/memory-channel-utils.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,aAAa,GAAI,eAAe,MAAM,EAAE,MAAM,UAAU,KAAG,MAEvE,CAAC"}
+{"version":3,"file":"memory-channel-utils.d.ts","sourceRoot":"","sources":["../../src/utils/memory-channel-utils.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,aAAa,GAAI,eAAe,MAAM,EAAE,MAAM,UAAU,KAAG,MAA8D,CAAC"}

package/dist/utils/memory-channel-utils.js

@@ -1,6 +1,4 @@
 import { sprintf } from 'sprintf-js';
 import { toHexWords } from './to-hex-words.js';
-export const formatChannel = (channelNumber, data) => {
-    return sprintf('%2d : %s', channelNumber, toHexWords(data));
-};
+export const formatChannel = (channelNumber, data) => sprintf('%2d : %s', channelNumber, toHexWords(data));
 //# sourceMappingURL=memory-channel-utils.js.map

package/dist/utils/memory-channel-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory-channel-utils.js","sourceRoot":"","sources":["../../src/utils/memory-channel-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,aAAqB,EAAE,IAAgB,EAAU,EAAE;IAC/E,OAAO,OAAO,CAAC,UAAU,EAAE,aAAa,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AAC9D,CAAC,CAAC","sourcesContent":["import { sprintf } from 'sprintf-js';\nimport { toHexWords } from './to-hex-words.js';\n\nexport const formatChannel = (channelNumber: number, data: Uint8Array): string => {\n  return sprintf('%2d : %s', channelNumber, toHexWords(data));\n};\n"]}
+{"version":3,"file":"memory-channel-utils.js","sourceRoot":"","sources":["../../src/utils/memory-channel-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,aAAqB,EAAE,IAAgB,EAAU,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,aAAa,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC","sourcesContent":["import { sprintf } from 'sprintf-js';\nimport { toHexWords } from './to-hex-words.js';\n\nexport const formatChannel = (channelNumber: number, data: Uint8Array): string => sprintf('%2d : %s', channelNumber, toHexWords(data));\n"]}

package/dist/utils/memory-data-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-data-utils.d.ts","sourceRoot":"","sources":["../../src/utils/memory-data-utils.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,gBAAgB,GAAI,SAAS,MAAM,EAAE,MAAM,UAAU,KAAG,MAEpE,CAAC"}
+{"version":3,"file":"memory-data-utils.d.ts","sourceRoot":"","sources":["../../src/utils/memory-data-utils.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,gBAAgB,GAAI,SAAS,MAAM,EAAE,MAAM,UAAU,KAAG,MAAyD,CAAC"}

package/dist/utils/memory-data-utils.js

@@ -1,6 +1,4 @@
 import { sprintf } from 'sprintf-js';
 import { toHexWords } from './to-hex-words.js';
-export const formatMemoryData = (address, data) => {
-    return sprintf('%04X : %s', address, toHexWords(data));
-};
+export const formatMemoryData = (address, data) => sprintf('%04X : %s', address, toHexWords(data));
 //# sourceMappingURL=memory-data-utils.js.map

package/dist/utils/memory-data-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory-data-utils.js","sourceRoot":"","sources":["../../src/utils/memory-data-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAAe,EAAE,IAAgB,EAAU,EAAE;IAC5E,OAAO,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AACzD,CAAC,CAAC","sourcesContent":["import { sprintf } from 'sprintf-js';\nimport { toHexWords } from './to-hex-words.js';\n\nexport const formatMemoryData = (address: number, data: Uint8Array): string => {\n  return sprintf('%04X : %s', address, toHexWords(data));\n};\n"]}
+{"version":3,"file":"memory-data-utils.js","sourceRoot":"","sources":["../../src/utils/memory-data-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAAe,EAAE,IAAgB,EAAU,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC","sourcesContent":["import { sprintf } from 'sprintf-js';\nimport { toHexWords } from './to-hex-words.js';\n\nexport const formatMemoryData = (address: number, data: Uint8Array): string => sprintf('%04X : %s', address, toHexWords(data));\n"]}

package/dist/utils/schema-validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-validator.d.ts","sourceRoot":"","sources":["../../src/utils/schema-validator.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,GAAG,CAAM;;IAUjB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB;CAmBzD"}
+{"version":3,"file":"schema-validator.d.ts","sourceRoot":"","sources":["../../src/utils/schema-validator.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAOD,qBAAa,eAAe;IAC1B,OAAO,CAAC,GAAG,CAAM;;IAUjB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB;CAqBzD"}

package/dist/utils/schema-validator.js

@@ -1,4 +1,4 @@
-import Ajv from 'ajv';
+import { Ajv } from 'ajv';
 import addFormats from 'ajv-formats';
 import radioProtocolSchema from '../schemas/radio-protocol-schema.json' with { type: 'json' };
 export class SchemaValidator {
@@ -16,10 +16,13 @@ export class SchemaValidator {
         if (valid) {
             return { valid: true };
         }
-        const errors = validate.errors?.map((error) => {
-            const path = error.instancePath || 'root';
-            return `${path}: ${error.message}`;
-        }) || [];
+        let errors = [];
+        if (validate.errors && validate.errors.length > 0) {
+            errors = validate.errors.map((error) => {
+                const path = error.instancePath || 'root';
+                return `${path}: ${error.message}`;
+            });
+        }
         return {
             errors,
             valid: false,

package/dist/utils/schema-validator.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema-validator.js","sourceRoot":"","sources":["../../src/utils/schema-validator.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,mBAAmB,MAAM,uCAAuC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAO9F,MAAM,OAAO,eAAe;IAClB,GAAG,CAAM;IAEjB;QACE,IAAI,CAAC,GAAG,GAAG,IAAK,GAAW,CAAC;YAC1B,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QACF,UAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,qBAAqB,CAAC,MAAe;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QAE/B,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACzB,CAAC;QAED,MAAM,MAAM,GACV,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,KAAkD,EAAE,EAAE;YAC1E,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,IAAI,MAAM,CAAC;YAC1C,OAAO,GAAG,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;QACrC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEX,OAAO;YACL,MAAM;YACN,KAAK,EAAE,KAAK;SACb,CAAC;IACJ,CAAC;CACF","sourcesContent":["import Ajv from 'ajv';\nimport addFormats from 'ajv-formats';\nimport radioProtocolSchema from '../schemas/radio-protocol-schema.json' with { type: 'json' };\n\nexport interface ValidationResult {\n  valid: boolean;\n  errors?: string[];\n}\n\nexport class SchemaValidator {\n  private ajv: any;\n\n  constructor() {\n    this.ajv = new (Ajv as any)({\n      allErrors: true,\n      verbose: true,\n    });\n    (addFormats as any)(this.ajv);\n  }\n\n  validateRadioProtocol(config: unknown): ValidationResult {\n    const validate = this.ajv.compile(radioProtocolSchema);\n    const valid = validate(config);\n\n    if (valid) {\n      return { valid: true };\n    }\n\n    const errors =\n      validate.errors?.map((error: { instancePath?: string; message?: string }) => {\n        const path = error.instancePath || 'root';\n        return `${path}: ${error.message}`;\n      }) || [];\n\n    return {\n      errors,\n      valid: false,\n    };\n  }\n}\n"]}
+{"version":3,"file":"schema-validator.js","sourceRoot":"","sources":["../../src/utils/schema-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC1B,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,mBAAmB,MAAM,uCAAuC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAY9F,MAAM,OAAO,eAAe;IAClB,GAAG,CAAM;IAEjB;QACE,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,CAAC;YACjB,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QACF,UAA2C,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzD,CAAC;IAED,qBAAqB,CAAC,MAAe;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QAE/B,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACzB,CAAC;QAED,IAAI,MAAM,GAAa,EAAE,CAAC;QAC1B,IAAI,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAe,EAAE,EAAE;gBAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,IAAI,MAAM,CAAC;gBAC1C,OAAO,GAAG,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;YACrC,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,MAAM;YACN,KAAK,EAAE,KAAK;SACb,CAAC;IACJ,CAAC;CACF","sourcesContent":["import { Ajv } from 'ajv';\nimport addFormats from 'ajv-formats';\nimport radioProtocolSchema from '../schemas/radio-protocol-schema.json' with { type: 'json' };\n\nexport interface ValidationResult {\n  valid: boolean;\n  errors?: string[];\n}\n\ninterface AjvError {\n  instancePath?: string;\n  message?: string;\n}\n\nexport class SchemaValidator {\n  private ajv: Ajv;\n\n  constructor() {\n    this.ajv = new Ajv({\n      allErrors: true,\n      verbose: true,\n    });\n    (addFormats as unknown as (ajv: Ajv) => Ajv)(this.ajv);\n  }\n\n  validateRadioProtocol(config: unknown): ValidationResult {\n    const validate = this.ajv.compile(radioProtocolSchema);\n    const valid = validate(config);\n\n    if (valid) {\n      return { valid: true };\n    }\n\n    let errors: string[] = [];\n    if (validate.errors && validate.errors.length > 0) {\n      errors = validate.errors.map((error: AjvError) => {\n        const path = error.instancePath || 'root';\n        return `${path}: ${error.message}`;\n      });\n    }\n\n    return {\n      errors,\n      valid: false,\n    };\n  }\n}\n"]}

package/dist/utils/to-hex-words.js

@@ -1,11 +1,11 @@
 export const toHexWords = (data) => {
     const hexData = Buffer.from(data).toString('hex');
     let formattedData = '';
-    for (let i = 0; i < hexData.length; i += 4) {
-        if (0 != i) {
+    for (let index = 0; index < hexData.length; index += 4) {
+        if (index !== 0) {
             formattedData += ' ';
         }
-        formattedData += hexData.substring(i, i + 4);
+        formattedData += hexData.slice(index, index + 4);
     }
     return formattedData;
 };

package/dist/utils/to-hex-words.js.map

@@ -1 +1 @@
-{"version":3,"file":"to-hex-words.js","sourceRoot":"","sources":["../../src/utils/to-hex-words.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAgB,EAAU,EAAE;IACrD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,aAAa,GAAG,EAAE,CAAC;IAEvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACX,aAAa,IAAI,GAAG,CAAC;QACvB,CAAC;QAED,aAAa,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC,CAAC","sourcesContent":["export const toHexWords = (data: Uint8Array): string => {\n  const hexData = Buffer.from(data).toString('hex');\n  let formattedData = '';\n\n  for (let i = 0; i < hexData.length; i += 4) {\n    if (0 != i) {\n      formattedData += ' ';\n    }\n\n    formattedData += hexData.substring(i, i + 4);\n  }\n\n  return formattedData;\n};\n"]}
+{"version":3,"file":"to-hex-words.js","sourceRoot":"","sources":["../../src/utils/to-hex-words.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAgB,EAAU,EAAE;IACrD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,aAAa,GAAG,EAAE,CAAC;IAEvB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACvD,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,aAAa,IAAI,GAAG,CAAC;QACvB,CAAC;QAED,aAAa,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC,CAAC","sourcesContent":["export const toHexWords = (data: Uint8Array): string => {\n  const hexData = Buffer.from(data).toString('hex');\n  let formattedData = '';\n\n  for (let index = 0; index < hexData.length; index += 4) {\n    if (index !== 0) {\n      formattedData += ' ';\n    }\n\n    formattedData += hexData.slice(index, index + 4);\n  }\n\n  return formattedData;\n};\n"]}

package/dist/utils/ui-logger-factory.d.ts

@@ -1,8 +1,17 @@
+import type { LogLayerTransport } from '@loglayer/shared';
 import { UILogger } from './ui-logger.js';
+interface LogEntry {
+    data: unknown;
+    hasData: boolean;
+    level: string;
+    message: string;
+    timestamp: string;
+}
 export interface UILoggerConfig {
-    customTransport?: any;
+    customTransport?: LogLayerTransport;
     enableConsoleDebug?: boolean;
 }
 export declare const createUILogger: (config?: UILoggerConfig) => UILogger;
-export declare const createUILoggerWithCallback: (callback: (logEntry: any) => void, config?: UILoggerConfig) => UILogger;
+export declare const createUILoggerWithCallback: (callback: (logEntry: LogEntry) => void, config?: UILoggerConfig) => UILogger;
+export {};
 //# sourceMappingURL=ui-logger-factory.d.ts.map

package/dist/utils/ui-logger-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui-logger-factory.d.ts","sourceRoot":"","sources":["../../src/utils/ui-logger-factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AA2B1C,MAAM,WAAW,cAAc;IAC7B,eAAe,CAAC,EAAE,GAAG,CAAC;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,eAAO,MAAM,cAAc,GAA2B,SAAQ,cAAmB,KAAG,QAYnF,CAAC;AAEF,eAAO,MAAM,0BAA0B,GAAuC,UAAU,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,EAAE,SAAQ,cAAmB,KAAG,QAQ9I,CAAC"}
+{"version":3,"file":"ui-logger-factory.d.ts","sourceRoot":"","sources":["../../src/utils/ui-logger-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAI1D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,UAAU,QAAQ;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAmCD,MAAM,WAAW,cAAc;IAC7B,eAAe,CAAC,EAAE,iBAAiB,CAAC;IACpC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAQD,eAAO,MAAM,cAAc,GAA2B,SAAQ,cAAmB,KAAG,QAQnF,CAAC;AAEF,eAAO,MAAM,0BAA0B,GAAuC,UAAU,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,EAAE,SAAQ,cAAmB,KAAG,QAQnJ,CAAC"}

package/dist/utils/ui-logger-factory.js

@@ -1,3 +1,4 @@
+// eslint-disable-next-line no-duplicate-imports, sort-imports
 import { BaseTransport } from '@loglayer/transport';
 import { LogLayer } from 'loglayer';
 import { UILogger } from './ui-logger.js';
@@ -5,29 +6,38 @@ import { UILogger } from './ui-logger.js';
  * Custom LogLayer transport for capturing UI log entries.
  */
 const UILogTransport = class extends BaseTransport {
-    #callback;
+    callback;
     constructor(callback) {
         // Pass a dummy logger to BaseTransport
-        super({ enabled: true, id: 'ui-logger-transport', logger: { log: () => { } } });
-        this.#callback = callback;
+        super({
+            enabled: true,
+            id: 'ui-logger-transport',
+            logger: {
+                log: () => {
+                    // Empty function for dummy logger
+                },
+            },
+        });
+        this.callback = callback;
     }
     shipToLogger(params) {
         const logEntry = {
             data: params.data,
-            hasData: params.hasData,
+            hasData: params.hasData ?? false,
             level: params.logLevel,
             message: params.messages.join(' '),
             timestamp: new Date().toISOString(),
         };
-        this.#callback(logEntry);
+        this.callback(logEntry);
         return [];
     }
 };
+// Move defaultCallback to outer scope to avoid recreating it on every call
+const defaultCallback = (logEntry) => {
+    // eslint-disable-next-line no-console
+    console.log(JSON.stringify(logEntry));
+};
 export const createUILogger = function createUILogger(config = {}) {
-    // By default, just print to console as JSON
-    const defaultCallback = (logEntry) => {
-        console.log(JSON.stringify(logEntry));
-    };
     const transport = config.customTransport || new UILogTransport(defaultCallback);
     const logger = new LogLayer({
         consoleDebug: config.enableConsoleDebug ?? false,

package/dist/utils/ui-logger-factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"ui-logger-factory.js","sourceRoot":"","sources":["../../src/utils/ui-logger-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C;;GAEG;AACH,MAAM,cAAc,GAAG,KAAM,SAAQ,aAAkB;IACrD,SAAS,CAA0B;IAEnC,YAAY,QAAiC;QAC3C,uCAAuC;QACvC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/E,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAED,YAAY,CAAC,MAAW;QACtB,MAAM,QAAQ,GAAG;YACf,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,KAAK,EAAE,MAAM,CAAC,QAAQ;YACtB,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;YAClC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QACF,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACzB,OAAO,EAAE,CAAC;IACZ,CAAC;CACF,CAAC;AAOF,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,cAAc,CAAC,SAAyB,EAAE;IAC/E,4CAA4C;IAC5C,MAAM,eAAe,GAAG,CAAC,QAAa,EAAE,EAAE;QACxC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC;IACF,MAAM,SAAS,GAAG,MAAM,CAAC,eAAe,IAAI,IAAI,cAAc,CAAC,eAAe,CAAC,CAAC;IAChF,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC,kBAAkB,IAAI,KAAK;QAChD,SAAS;KACV,CAAC,CAAC;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACzB,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG,SAAS,0BAA0B,CAAC,QAAiC,EAAE,SAAyB,EAAE;IAC1I,MAAM,SAAS,GAAG,IAAI,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC,kBAAkB,IAAI,KAAK;QAChD,SAAS;KACV,CAAC,CAAC;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACzB,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC,CAAC","sourcesContent":["import { BaseTransport } from '@loglayer/transport';\nimport { LogLayer } from 'loglayer';\nimport { UILogger } from './ui-logger.js';\n\n/**\n * Custom LogLayer transport for capturing UI log entries.\n */\nconst UILogTransport = class extends BaseTransport<any> {\n  #callback: (logEntry: any) => void;\n\n  constructor(callback: (logEntry: any) => void) {\n    // Pass a dummy logger to BaseTransport\n    super({ enabled: true, id: 'ui-logger-transport', logger: { log: () => {} } });\n    this.#callback = callback;\n  }\n\n  shipToLogger(params: any) {\n    const logEntry = {\n      data: params.data,\n      hasData: params.hasData,\n      level: params.logLevel,\n      message: params.messages.join(' '),\n      timestamp: new Date().toISOString(),\n    };\n    this.#callback(logEntry);\n    return [];\n  }\n};\n\nexport interface UILoggerConfig {\n  customTransport?: any;\n  enableConsoleDebug?: boolean;\n}\n\nexport const createUILogger = function createUILogger(config: UILoggerConfig = {}): UILogger {\n  // By default, just print to console as JSON\n  const defaultCallback = (logEntry: any) => {\n    console.log(JSON.stringify(logEntry));\n  };\n  const transport = config.customTransport || new UILogTransport(defaultCallback);\n  const logger = new LogLayer({\n    consoleDebug: config.enableConsoleDebug ?? false,\n    transport,\n  });\n  logger.setLevel('debug');\n  return new UILogger(logger);\n};\n\nexport const createUILoggerWithCallback = function createUILoggerWithCallback(callback: (logEntry: any) => void, config: UILoggerConfig = {}): UILogger {\n  const transport = new UILogTransport(callback);\n  const logger = new LogLayer({\n    consoleDebug: config.enableConsoleDebug ?? false,\n    transport,\n  });\n  logger.setLevel('debug');\n  return new UILogger(logger);\n};\n"]}
+{"version":3,"file":"ui-logger-factory.js","sourceRoot":"","sources":["../../src/utils/ui-logger-factory.ts"],"names":[],"mappings":"AACA,8DAA8D;AAC9D,OAAO,EAAE,aAAa,EAAgC,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAU1C;;GAEG;AACH,MAAM,cAAc,GAAG,KAAM,SAAQ,aAAsB;IACjD,QAAQ,CAA+B;IAE/C,YAAY,QAAsC;QAChD,uCAAuC;QACvC,KAAK,CAAC;YACJ,OAAO,EAAE,IAAI;YACb,EAAE,EAAE,qBAAqB;YACzB,MAAM,EAAE;gBACN,GAAG,EAAE,GAAS,EAAE;oBACd,kCAAkC;gBACpC,CAAC;aACF;SACF,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,YAAY,CAAC,MAA+B;QAC1C,MAAM,QAAQ,GAAa;YACzB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,KAAK;YAChC,KAAK,EAAE,MAAM,CAAC,QAAQ;YACtB,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;YAClC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;CACF,CAAC;AAOF,2EAA2E;AAC3E,MAAM,eAAe,GAAG,CAAC,QAAkB,EAAQ,EAAE;IACnD,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;AACxC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,cAAc,CAAC,SAAyB,EAAE;IAC/E,MAAM,SAAS,GAAG,MAAM,CAAC,eAAe,IAAI,IAAI,cAAc,CAAC,eAAe,CAAC,CAAC;IAChF,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC,kBAAkB,IAAI,KAAK;QAChD,SAAS;KACV,CAAC,CAAC;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACzB,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG,SAAS,0BAA0B,CAAC,QAAsC,EAAE,SAAyB,EAAE;IAC/I,MAAM,SAAS,GAAG,IAAI,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC,kBAAkB,IAAI,KAAK;QAChD,SAAS;KACV,CAAC,CAAC;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACzB,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC,CAAC","sourcesContent":["import type { LogLayerTransport } from '@loglayer/shared';\n// eslint-disable-next-line no-duplicate-imports, sort-imports\nimport { BaseTransport, type LogLayerTransportParams } from '@loglayer/transport';\nimport { LogLayer } from 'loglayer';\nimport { UILogger } from './ui-logger.js';\n\ninterface LogEntry {\n  data: unknown;\n  hasData: boolean;\n  level: string;\n  message: string;\n  timestamp: string;\n}\n\n/**\n * Custom LogLayer transport for capturing UI log entries.\n */\nconst UILogTransport = class extends BaseTransport<unknown> {\n  private callback: (logEntry: LogEntry) => void;\n\n  constructor(callback: (logEntry: LogEntry) => void) {\n    // Pass a dummy logger to BaseTransport\n    super({\n      enabled: true,\n      id: 'ui-logger-transport',\n      logger: {\n        log: (): void => {\n          // Empty function for dummy logger\n        },\n      },\n    });\n    this.callback = callback;\n  }\n\n  shipToLogger(params: LogLayerTransportParams): unknown[] {\n    const logEntry: LogEntry = {\n      data: params.data,\n      hasData: params.hasData ?? false,\n      level: params.logLevel,\n      message: params.messages.join(' '),\n      timestamp: new Date().toISOString(),\n    };\n    this.callback(logEntry);\n    return [];\n  }\n};\n\nexport interface UILoggerConfig {\n  customTransport?: LogLayerTransport;\n  enableConsoleDebug?: boolean;\n}\n\n// Move defaultCallback to outer scope to avoid recreating it on every call\nconst defaultCallback = (logEntry: LogEntry): void => {\n  // eslint-disable-next-line no-console\n  console.log(JSON.stringify(logEntry));\n};\n\nexport const createUILogger = function createUILogger(config: UILoggerConfig = {}): UILogger {\n  const transport = config.customTransport || new UILogTransport(defaultCallback);\n  const logger = new LogLayer({\n    consoleDebug: config.enableConsoleDebug ?? false,\n    transport,\n  });\n  logger.setLevel('debug');\n  return new UILogger(logger);\n};\n\nexport const createUILoggerWithCallback = function createUILoggerWithCallback(callback: (logEntry: LogEntry) => void, config: UILoggerConfig = {}): UILogger {\n  const transport = new UILogTransport(callback);\n  const logger = new LogLayer({\n    consoleDebug: config.enableConsoleDebug ?? false,\n    transport,\n  });\n  logger.setLevel('debug');\n  return new UILogger(logger);\n};\n"]}

package/dist/utils/ui-logger.d.ts

@@ -20,12 +20,13 @@ import type { ILogLayer } from 'loglayer';
  * - Structured data supports rich UI representations
  * - Separate from debug logging avoids UI noise
  */
+interface ProtocolContext {
+    variables?: Map<string, unknown>;
+}
 /**
  * Generic protocol step interface for UI logging
  */
-export interface UIProtocolStep {
-    [key: string]: any;
-}
+export type UIProtocolStep = Record<string, unknown>;
 /**
  * UI Logger for capturing command-level information for UI display
  */
@@ -34,10 +35,11 @@ export declare class UILogger {
     private commandStartTimes;
     constructor(logger: ILogLayer);
     startCommand(stepIndex: number, totalSteps: number, operation: string, step: UIProtocolStep): void;
-    logCommandSuccess(stepIndex: number, totalSteps: number, operation: string, step: UIProtocolStep, context: any): void;
-    logCommandFailure(stepIndex: number, totalSteps: number, operation: string, step: UIProtocolStep, error: Error, context: any): void;
+    logCommandSuccess(stepIndex: number, totalSteps: number, operation: string, step: UIProtocolStep, context: ProtocolContext): void;
+    logCommandFailure(stepIndex: number, totalSteps: number, operation: string, step: UIProtocolStep, error: Error, context: ProtocolContext): void;
     private getCommandType;
     private getStepDescription;
     private getExpectedData;
 }
+export {};
 //# sourceMappingURL=ui-logger.d.ts.map

package/dist/utils/ui-logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui-logger.d.ts","sourceRoot":"","sources":["../../src/utils/ui-logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,iBAAiB,CAA6B;gBAE1C,MAAM,EAAE,SAAS;IAK7B,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI;IAsBlG,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI;IA6CrH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI;IAkCnI,OAAO,CAAC,cAAc;IAsBtB,OAAO,CAAC,kBAAkB;IAmB1B,OAAO,CAAC,eAAe;CAiBxB"}
+{"version":3,"file":"ui-logger.d.ts","sourceRoot":"","sources":["../../src/utils/ui-logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,UAAU,eAAe;IACvB,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA0BrD;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,iBAAiB,CAA6B;gBAE1C,MAAM,EAAE,SAAS;IAK7B,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI;IAsBlG,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IA2CjI,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAmC/I,OAAO,CAAC,cAAc;IAsBtB,OAAO,CAAC,kBAAkB;IAmB1B,OAAO,CAAC,eAAe;CAoBxB"}

package/dist/utils/ui-logger.js

@@ -1,3 +1,20 @@
+/**
+ * Type guards for protocol step properties
+ */
+const hasDescription = (obj) => typeof obj === 'object' && obj !== null && 'description' in obj && typeof obj.description === 'string';
+const hasReceive = (obj) => typeof obj === 'object' && obj !== null && 'receive' in obj;
+const hasEndChunk = (obj) => typeof obj === 'object' &&
+    obj !== null &&
+    'endChunk' in obj &&
+    typeof obj.endChunk === 'object' &&
+    obj.endChunk !== null &&
+    'receive' in obj.endChunk;
+const hasStartChunk = (obj) => typeof obj === 'object' &&
+    obj !== null &&
+    'startChunk' in obj &&
+    typeof obj.startChunk === 'object' &&
+    obj.startChunk !== null &&
+    'receive' in obj.startChunk;
 /**
  * UI Logger for capturing command-level information for UI display
  */
@@ -35,18 +52,16 @@ export class UILogger {
         const commandType = this.getCommandType(step);
         const description = this.getStepDescription(step);
         // Extract sent and received data from context
-        const dataSent = context.variables?.get('lastSentData');
-        const dataReceived = context.variables?.get('lastReceivedData');
+        const dataSent = context.variables && context.variables.get('lastSentData');
+        const dataReceived = context.variables && context.variables.get('lastReceivedData');
         const dataExpected = this.getExpectedData(step);
         // For readSegment, also extract chunk logs if present
-        let dataChunks = undefined;
-        if ('readSegment' === commandType) {
-            dataChunks = context.variables?.get('lastReadSegmentChunks');
-            // For readSegment, we don't need the flattened dataSent/dataReceived since we have dataChunks
-        }
+        const dataChunks = commandType === 'readSegment' && context.variables && context.variables.get('lastReadSegmentChunks');
         // Convert dataSent and dataReceived to byte array format if they exist
-        const dataSentArray = dataSent ? [...dataSent] : undefined;
-        const dataReceivedArray = dataReceived ? [...dataReceived] : undefined;
+        // eslint-disable-next-line unicorn/prefer-spread
+        const dataSentArray = dataSent && Array.from(dataSent);
+        // eslint-disable-next-line unicorn/prefer-spread
+        const dataReceivedArray = dataReceived && Array.from(dataReceived);
         this.logger
             .withMetadata({
             commandType,
@@ -74,10 +89,11 @@ export class UILogger {
         const commandType = this.getCommandType(step);
         const description = this.getStepDescription(step);
         // Extract sent data from context
-        const dataSent = context.variables?.get('lastSentData');
+        const dataSent = context.variables && context.variables.get('lastSentData');
         const dataExpected = this.getExpectedData(step);
         // Convert dataSent to byte array format if it exists
-        const dataSentArray = dataSent ? [...dataSent] : undefined;
+        // eslint-disable-next-line unicorn/prefer-spread
+        const dataSentArray = dataSent && Array.from(dataSent);
         this.logger
             .withMetadata({
             commandType,
@@ -117,25 +133,25 @@ export class UILogger {
         return 'unknown';
     }
     getStepDescription(step) {
-        if ('sendReceive' in step && step.sendReceive.description) {
+        if ('sendReceive' in step && hasDescription(step.sendReceive)) {
             return step.sendReceive.description;
         }
-        if ('send' in step && step.send.description) {
+        if ('send' in step && hasDescription(step.send)) {
             return step.send.description;
         }
-        if ('receive' in step && step.receive.description) {
+        if ('receive' in step && hasDescription(step.receive)) {
             return step.receive.description;
         }
-        if ('readSegment' in step && step.readSegment.description) {
+        if ('readSegment' in step && hasDescription(step.readSegment)) {
             return step.readSegment.description;
         }
-        if ('writeSegment' in step && step.writeSegment.description) {
+        if ('writeSegment' in step && hasDescription(step.writeSegment)) {
             return step.writeSegment.description;
         }
         return 'No description';
     }
     getExpectedData(step) {
-        if ('sendReceive' in step && step.sendReceive.receive) {
+        if ('sendReceive' in step && hasReceive(step.sendReceive)) {
             return step.sendReceive.receive;
         }
         if ('receive' in step) {
@@ -143,13 +159,16 @@ export class UILogger {
         }
         if ('readSegment' in step) {
             // For readSegment, return both start and end chunk receive patterns
-            return {
-                endChunk: step.readSegment.endChunk.receive,
-                startChunk: step.readSegment.startChunk.receive,
-                type: 'readSegment',
-            };
+            const { readSegment } = step;
+            if (hasEndChunk(readSegment) && hasStartChunk(readSegment)) {
+                return {
+                    endChunk: readSegment.endChunk.receive,
+                    startChunk: readSegment.startChunk.receive,
+                    type: 'readSegment',
+                };
+            }
         }
-        return undefined;
+        return {};
     }
 }
 //# sourceMappingURL=ui-logger.js.map

package/dist/utils/ui-logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"ui-logger.js","sourceRoot":"","sources":["../../src/utils/ui-logger.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ILogLayer } from 'loglayer';\n\n/**\n * UI Logger: Command-Level Logging for UI Display\n *\n * This module provides a specialized logger for capturing command-level information\n * that can be easily parsed and displayed in a UI. It captures details about\n * commands, data sent, data expected, and data received in a structured format.\n *\n * Purpose:\n * - Captures command-level information for UI display\n * - Provides structured JSON logging for easy parsing\n * - Tracks command execution details including timing\n * - Supports protocol debugging in UI environments\n * - Maintains separation from debug logging\n *\n * Design Rationale:\n * - Single log entry per command provides clean UI display\n * - JSON structure enables easy parsing and filtering\n * - Command-level granularity is appropriate for UI debugging\n * - Structured data supports rich UI representations\n * - Separate from debug logging avoids UI noise\n */\n\n/**\n * Generic protocol step interface for UI logging\n */\nexport interface UIProtocolStep {\n  [key: string]: any;\n}\n\n/**\n * UI Logger for capturing command-level information for UI display\n */\nexport class UILogger {\n  private logger: ILogLayer;\n  private commandStartTimes = new Map<string, number>();\n\n  constructor(logger: ILogLayer) {\n    this.logger = logger;\n  }\n\n  // eslint-disable-next-line max-params\n  startCommand(stepIndex: number, totalSteps: number, operation: string, step: UIProtocolStep): void {\n    const commandId = `${operation}-${stepIndex}`;\n    const startTime = Date.now();\n    this.commandStartTimes.set(commandId, startTime);\n\n    const commandType = this.getCommandType(step);\n    const description = this.getStepDescription(step);\n\n    this.logger\n      .withMetadata({\n        commandId,\n        commandType,\n        description,\n        operation,\n        startTime,\n        stepIndex,\n        totalSteps,\n      })\n      .info('Command started');\n  }\n\n  // eslint-disable-next-line max-params\n  logCommandSuccess(stepIndex: number, totalSteps: number, operation: string, step: UIProtocolStep, context: any): void {\n    const commandId = `${operation}-${stepIndex}`;\n    const startTime = this.commandStartTimes.get(commandId) || Date.now();\n    const endTime = Date.now();\n    const duration = endTime - startTime;\n\n    const commandType = this.getCommandType(step);\n    const description = this.getStepDescription(step);\n\n    // Extract sent and received data from context\n    const dataSent = context.variables?.get('lastSentData');\n    const dataReceived = context.variables?.get('lastReceivedData');\n    const dataExpected = this.getExpectedData(step);\n\n    // For readSegment, also extract chunk logs if present\n    let dataChunks = undefined;\n    if ('readSegment' === commandType) {\n      dataChunks = context.variables?.get('lastReadSegmentChunks');\n      // For readSegment, we don't need the flattened dataSent/dataReceived since we have dataChunks\n    }\n\n    // Convert dataSent and dataReceived to byte array format if they exist\n    const dataSentArray = dataSent ? [...dataSent] : undefined;\n    const dataReceivedArray = dataReceived ? [...dataReceived] : undefined;\n\n    this.logger\n      .withMetadata({\n        commandType,\n        dataChunks,\n        dataExpected,\n        dataReceived: dataReceivedArray,\n        dataSent: dataSentArray,\n        description,\n        duration,\n        endTime,\n        operation,\n        startTime,\n        stepIndex,\n        success: true,\n        totalSteps,\n      })\n      .info('Command completed successfully');\n  }\n\n  // eslint-disable-next-line max-params\n  logCommandFailure(stepIndex: number, totalSteps: number, operation: string, step: UIProtocolStep, error: Error, context: any): void {\n    const commandId = `${operation}-${stepIndex}`;\n    const startTime = this.commandStartTimes.get(commandId) || Date.now();\n    const endTime = Date.now();\n    const duration = endTime - startTime;\n\n    const commandType = this.getCommandType(step);\n    const description = this.getStepDescription(step);\n\n    // Extract sent data from context\n    const dataSent = context.variables?.get('lastSentData');\n    const dataExpected = this.getExpectedData(step);\n\n    // Convert dataSent to byte array format if it exists\n    const dataSentArray = dataSent ? [...dataSent] : undefined;\n\n    this.logger\n      .withMetadata({\n        commandType,\n        dataExpected,\n        dataSent: dataSentArray,\n        description,\n        duration,\n        endTime,\n        error: error.message,\n        operation,\n        startTime,\n        stepIndex,\n        success: false,\n        totalSteps,\n      })\n      .info('Command failed');\n  }\n\n  private getCommandType(step: UIProtocolStep): string {\n    if ('sendReceive' in step) {\n      return 'sendReceive';\n    }\n    if ('send' in step) {\n      return 'send';\n    }\n    if ('receive' in step) {\n      return 'receive';\n    }\n    if ('readSegment' in step) {\n      return 'readSegment';\n    }\n    if ('writeSegment' in step) {\n      return 'writeSegment';\n    }\n    if ('setVariable' in step) {\n      return 'setVariable';\n    }\n    return 'unknown';\n  }\n\n  private getStepDescription(step: UIProtocolStep): string {\n    if ('sendReceive' in step && step.sendReceive.description) {\n      return step.sendReceive.description;\n    }\n    if ('send' in step && step.send.description) {\n      return step.send.description;\n    }\n    if ('receive' in step && step.receive.description) {\n      return step.receive.description;\n    }\n    if ('readSegment' in step && step.readSegment.description) {\n      return step.readSegment.description;\n    }\n    if ('writeSegment' in step && step.writeSegment.description) {\n      return step.writeSegment.description;\n    }\n    return 'No description';\n  }\n\n  private getExpectedData(step: UIProtocolStep): any {\n    if ('sendReceive' in step && step.sendReceive.receive) {\n      return step.sendReceive.receive;\n    }\n    if ('receive' in step) {\n      return step.receive;\n    }\n    if ('readSegment' in step) {\n      // For readSegment, return both start and end chunk receive patterns\n      return {\n        endChunk: step.readSegment.endChunk.receive,\n        startChunk: step.readSegment.startChunk.receive,\n        type: 'readSegment',\n      };\n    }\n    return undefined;\n  }\n}\n"]}
+{"version":3,"file":"ui-logger.js","sourceRoot":"","sources":["../../src/utils/ui-logger.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ILogLayer } from 'loglayer';\n\n/**\n * UI Logger: Command-Level Logging for UI Display\n *\n * This module provides a specialized logger for capturing command-level information\n * that can be easily parsed and displayed in a UI. It captures details about\n * commands, data sent, data expected, and data received in a structured format.\n *\n * Purpose:\n * - Captures command-level information for UI display\n * - Provides structured JSON logging for easy parsing\n * - Tracks command execution details including timing\n * - Supports protocol debugging in UI environments\n * - Maintains separation from debug logging\n *\n * Design Rationale:\n * - Single log entry per command provides clean UI display\n * - JSON structure enables easy parsing and filtering\n * - Command-level granularity is appropriate for UI debugging\n * - Structured data supports rich UI representations\n * - Separate from debug logging avoids UI noise\n */\n\ninterface ProtocolContext {\n  variables?: Map<string, unknown>;\n}\n\n/**\n * Generic protocol step interface for UI logging\n */\nexport type UIProtocolStep = Record<string, unknown>;\n\n/**\n * Type guards for protocol step properties\n */\nconst hasDescription = (obj: unknown): obj is { description: string } =>\n  typeof obj === 'object' && obj !== null && 'description' in obj && typeof (obj as Record<string, unknown>).description === 'string';\n\nconst hasReceive = (obj: unknown): obj is { receive: unknown } => typeof obj === 'object' && obj !== null && 'receive' in obj;\n\nconst hasEndChunk = (obj: unknown): obj is { endChunk: { receive: unknown } } =>\n  typeof obj === 'object' &&\n  obj !== null &&\n  'endChunk' in obj &&\n  typeof (obj as Record<string, unknown>).endChunk === 'object' &&\n  (obj as Record<string, unknown>).endChunk !== null &&\n  'receive' in ((obj as Record<string, unknown>).endChunk as Record<string, unknown>);\n\nconst hasStartChunk = (obj: unknown): obj is { startChunk: { receive: unknown } } =>\n  typeof obj === 'object' &&\n  obj !== null &&\n  'startChunk' in obj &&\n  typeof (obj as Record<string, unknown>).startChunk === 'object' &&\n  (obj as Record<string, unknown>).startChunk !== null &&\n  'receive' in ((obj as Record<string, unknown>).startChunk as Record<string, unknown>);\n\n/**\n * UI Logger for capturing command-level information for UI display\n */\nexport class UILogger {\n  private logger: ILogLayer;\n  private commandStartTimes = new Map<string, number>();\n\n  constructor(logger: ILogLayer) {\n    this.logger = logger;\n  }\n\n  // eslint-disable-next-line max-params\n  startCommand(stepIndex: number, totalSteps: number, operation: string, step: UIProtocolStep): void {\n    const commandId = `${operation}-${stepIndex}`;\n    const startTime = Date.now();\n    this.commandStartTimes.set(commandId, startTime);\n\n    const commandType = this.getCommandType(step);\n    const description = this.getStepDescription(step);\n\n    this.logger\n      .withMetadata({\n        commandId,\n        commandType,\n        description,\n        operation,\n        startTime,\n        stepIndex,\n        totalSteps,\n      })\n      .info('Command started');\n  }\n\n  // eslint-disable-next-line max-params\n  logCommandSuccess(stepIndex: number, totalSteps: number, operation: string, step: UIProtocolStep, context: ProtocolContext): void {\n    const commandId = `${operation}-${stepIndex}`;\n    const startTime = this.commandStartTimes.get(commandId) || Date.now();\n    const endTime = Date.now();\n    const duration = endTime - startTime;\n\n    const commandType = this.getCommandType(step);\n    const description = this.getStepDescription(step);\n\n    // Extract sent and received data from context\n    const dataSent = context.variables && context.variables.get('lastSentData');\n    const dataReceived = context.variables && context.variables.get('lastReceivedData');\n    const dataExpected = this.getExpectedData(step);\n\n    // For readSegment, also extract chunk logs if present\n    const dataChunks = commandType === 'readSegment' && context.variables && context.variables.get('lastReadSegmentChunks');\n\n    // Convert dataSent and dataReceived to byte array format if they exist\n    // eslint-disable-next-line unicorn/prefer-spread\n    const dataSentArray = dataSent && Array.from(dataSent as Uint8Array);\n    // eslint-disable-next-line unicorn/prefer-spread\n    const dataReceivedArray = dataReceived && Array.from(dataReceived as Uint8Array);\n\n    this.logger\n      .withMetadata({\n        commandType,\n        dataChunks,\n        dataExpected,\n        dataReceived: dataReceivedArray,\n        dataSent: dataSentArray,\n        description,\n        duration,\n        endTime,\n        operation,\n        startTime,\n        stepIndex,\n        success: true,\n        totalSteps,\n      })\n      .info('Command completed successfully');\n  }\n\n  // eslint-disable-next-line max-params\n  logCommandFailure(stepIndex: number, totalSteps: number, operation: string, step: UIProtocolStep, error: Error, context: ProtocolContext): void {\n    const commandId = `${operation}-${stepIndex}`;\n    const startTime = this.commandStartTimes.get(commandId) || Date.now();\n    const endTime = Date.now();\n    const duration = endTime - startTime;\n\n    const commandType = this.getCommandType(step);\n    const description = this.getStepDescription(step);\n\n    // Extract sent data from context\n    const dataSent = context.variables && context.variables.get('lastSentData');\n    const dataExpected = this.getExpectedData(step);\n\n    // Convert dataSent to byte array format if it exists\n    // eslint-disable-next-line unicorn/prefer-spread\n    const dataSentArray = dataSent && Array.from(dataSent as Uint8Array);\n\n    this.logger\n      .withMetadata({\n        commandType,\n        dataExpected,\n        dataSent: dataSentArray,\n        description,\n        duration,\n        endTime,\n        error: error.message,\n        operation,\n        startTime,\n        stepIndex,\n        success: false,\n        totalSteps,\n      })\n      .info('Command failed');\n  }\n\n  private getCommandType(step: UIProtocolStep): string {\n    if ('sendReceive' in step) {\n      return 'sendReceive';\n    }\n    if ('send' in step) {\n      return 'send';\n    }\n    if ('receive' in step) {\n      return 'receive';\n    }\n    if ('readSegment' in step) {\n      return 'readSegment';\n    }\n    if ('writeSegment' in step) {\n      return 'writeSegment';\n    }\n    if ('setVariable' in step) {\n      return 'setVariable';\n    }\n    return 'unknown';\n  }\n\n  private getStepDescription(step: UIProtocolStep): string {\n    if ('sendReceive' in step && hasDescription(step.sendReceive)) {\n      return step.sendReceive.description;\n    }\n    if ('send' in step && hasDescription(step.send)) {\n      return step.send.description;\n    }\n    if ('receive' in step && hasDescription(step.receive)) {\n      return step.receive.description;\n    }\n    if ('readSegment' in step && hasDescription(step.readSegment)) {\n      return step.readSegment.description;\n    }\n    if ('writeSegment' in step && hasDescription(step.writeSegment)) {\n      return step.writeSegment.description;\n    }\n    return 'No description';\n  }\n\n  private getExpectedData(step: UIProtocolStep): unknown {\n    if ('sendReceive' in step && hasReceive(step.sendReceive)) {\n      return step.sendReceive.receive;\n    }\n    if ('receive' in step) {\n      return step.receive;\n    }\n    if ('readSegment' in step) {\n      // For readSegment, return both start and end chunk receive patterns\n      const { readSegment } = step;\n      if (hasEndChunk(readSegment) && hasStartChunk(readSegment)) {\n        return {\n          endChunk: readSegment.endChunk.receive,\n          startChunk: readSegment.startChunk.receive,\n          type: 'readSegment',\n        };\n      }\n    }\n    return {};\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@springfield/ham-radio-utils",
-  "version": "2.2.1",
+  "version": "3.0.0",
   "author": "Bryan Hunt",
   "license": "MIT",
   "packageManager": "yarn@4.9.2",
@@ -15,8 +15,8 @@
   "scripts": {
     "build": "tsc && cp src/db/* dist/db/ && cp src/schemas/* dist/schemas/",
     "commitlint": "commitlint --edit",
-    "lint": "oxlint",
-    "lint:fix": "oxlint --fix --fix-suggestions",
+    "lint": "oxlint --import-plugin --tsconfig tsconfig.json",
+    "lint:fix": "oxlint --import-plugin --tsconfig tsconfig.json --fix --fix-suggestions",
     "release": "semantic-release",
     "prepare": "husky"
   },
@@ -51,7 +51,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@springfield/ham-radio-api": "^16.1.1",
+    "@springfield/ham-radio-api": "^16.1.3",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "fishery": "^2.3.1",
@@ -68,9 +68,9 @@
     "@types/sprintf-js": "1.1.4",
     "chai": "5.2.1",
     "husky": "9.1.7",
-    "oxlint": "1.3.0",
+    "oxlint": "1.11.2",
     "semantic-release": "23.1.1",
     "semantic-release-yarn": "3.0.2",
-    "typescript": "5.8.3"
+    "typescript": "5.9.2"
   }
 }

package/src/index.ts

@@ -3,12 +3,10 @@ export * from './memory/segmented-memory.js';
 export * from './test-utils/radio-channel-factory.js';
 export * from './test-utils/radio-programmed-channel-factory.js';
 
-export * from './utils/bcd-to-number.js';
 export * from './utils/band-plan.js';
 export * from './utils/frequency-display.js';
 export * from './utils/memory-channel-utils.js';
 export * from './utils/memory-data-utils.js';
-export * from './utils/number-to-bcd.js';
 export * from './utils/schema-validator.js';
 export * from './utils/to-hex-words.js';
 export * from './utils/ui-logger.js';

package/src/memory/segmented-memory.ts

@@ -6,7 +6,7 @@ export class RadioSegmentedMemory {
   constructor(segments?: RadioMemorySegment[]) {
     this.segments = new Map();
 
-    if (segments != undefined) {
+    if (segments) {
       for (const segment of segments) {
         this.segments.set(segment.startAddress, segment);
       }
@@ -43,7 +43,7 @@ export class RadioSegmentedMemory {
       result = iterator.next();
     }
 
-    return undefined;
+    return {} as RadioMemorySegment;
   }
 
   public toArray(): RadioMemorySegment[] {

package/src/utils/memory-channel-utils.ts

@@ -1,6 +1,4 @@
 import { sprintf } from 'sprintf-js';
 import { toHexWords } from './to-hex-words.js';
 
-export const formatChannel = (channelNumber: number, data: Uint8Array): string => {
-  return sprintf('%2d : %s', channelNumber, toHexWords(data));
-};
+export const formatChannel = (channelNumber: number, data: Uint8Array): string => sprintf('%2d : %s', channelNumber, toHexWords(data));

package/src/utils/memory-data-utils.ts

@@ -1,6 +1,4 @@
 import { sprintf } from 'sprintf-js';
 import { toHexWords } from './to-hex-words.js';
 
-export const formatMemoryData = (address: number, data: Uint8Array): string => {
-  return sprintf('%04X : %s', address, toHexWords(data));
-};
+export const formatMemoryData = (address: number, data: Uint8Array): string => sprintf('%04X : %s', address, toHexWords(data));

package/src/utils/schema-validator.ts

@@ -1,4 +1,4 @@
-import Ajv from 'ajv';
+import { Ajv } from 'ajv';
 import addFormats from 'ajv-formats';
 import radioProtocolSchema from '../schemas/radio-protocol-schema.json' with { type: 'json' };
 
@@ -7,15 +7,20 @@ export interface ValidationResult {
   errors?: string[];
 }
 
+interface AjvError {
+  instancePath?: string;
+  message?: string;
+}
+
 export class SchemaValidator {
-  private ajv: any;
+  private ajv: Ajv;
 
   constructor() {
-    this.ajv = new (Ajv as any)({
+    this.ajv = new Ajv({
       allErrors: true,
       verbose: true,
     });
-    (addFormats as any)(this.ajv);
+    (addFormats as unknown as (ajv: Ajv) => Ajv)(this.ajv);
   }
 
   validateRadioProtocol(config: unknown): ValidationResult {
@@ -26,11 +31,13 @@ export class SchemaValidator {
       return { valid: true };
     }
 
-    const errors =
-      validate.errors?.map((error: { instancePath?: string; message?: string }) => {
+    let errors: string[] = [];
+    if (validate.errors && validate.errors.length > 0) {
+      errors = validate.errors.map((error: AjvError) => {
         const path = error.instancePath || 'root';
         return `${path}: ${error.message}`;
-      }) || [];
+      });
+    }
 
     return {
       errors,

package/src/utils/to-hex-words.ts

@@ -2,12 +2,12 @@ export const toHexWords = (data: Uint8Array): string => {
   const hexData = Buffer.from(data).toString('hex');
   let formattedData = '';
 
-  for (let i = 0; i < hexData.length; i += 4) {
-    if (0 != i) {
+  for (let index = 0; index < hexData.length; index += 4) {
+    if (index !== 0) {
       formattedData += ' ';
     }
 
-    formattedData += hexData.substring(i, i + 4);
+    formattedData += hexData.slice(index, index + 4);
   }
 
   return formattedData;

package/src/utils/ui-logger-factory.ts

@@ -1,42 +1,62 @@
-import { BaseTransport } from '@loglayer/transport';
+import type { LogLayerTransport } from '@loglayer/shared';
+// eslint-disable-next-line no-duplicate-imports, sort-imports
+import { BaseTransport, type LogLayerTransportParams } from '@loglayer/transport';
 import { LogLayer } from 'loglayer';
 import { UILogger } from './ui-logger.js';
 
+interface LogEntry {
+  data: unknown;
+  hasData: boolean;
+  level: string;
+  message: string;
+  timestamp: string;
+}
+
 /**
  * Custom LogLayer transport for capturing UI log entries.
  */
-const UILogTransport = class extends BaseTransport<any> {
-  #callback: (logEntry: any) => void;
+const UILogTransport = class extends BaseTransport<unknown> {
+  private callback: (logEntry: LogEntry) => void;
 
-  constructor(callback: (logEntry: any) => void) {
+  constructor(callback: (logEntry: LogEntry) => void) {
     // Pass a dummy logger to BaseTransport
-    super({ enabled: true, id: 'ui-logger-transport', logger: { log: () => {} } });
-    this.#callback = callback;
+    super({
+      enabled: true,
+      id: 'ui-logger-transport',
+      logger: {
+        log: (): void => {
+          // Empty function for dummy logger
+        },
+      },
+    });
+    this.callback = callback;
   }
 
-  shipToLogger(params: any) {
-    const logEntry = {
+  shipToLogger(params: LogLayerTransportParams): unknown[] {
+    const logEntry: LogEntry = {
       data: params.data,
-      hasData: params.hasData,
+      hasData: params.hasData ?? false,
       level: params.logLevel,
       message: params.messages.join(' '),
       timestamp: new Date().toISOString(),
     };
-    this.#callback(logEntry);
+    this.callback(logEntry);
     return [];
   }
 };
 
 export interface UILoggerConfig {
-  customTransport?: any;
+  customTransport?: LogLayerTransport;
   enableConsoleDebug?: boolean;
 }
 
+// Move defaultCallback to outer scope to avoid recreating it on every call
+const defaultCallback = (logEntry: LogEntry): void => {
+  // eslint-disable-next-line no-console
+  console.log(JSON.stringify(logEntry));
+};
+
 export const createUILogger = function createUILogger(config: UILoggerConfig = {}): UILogger {
-  // By default, just print to console as JSON
-  const defaultCallback = (logEntry: any) => {
-    console.log(JSON.stringify(logEntry));
-  };
   const transport = config.customTransport || new UILogTransport(defaultCallback);
   const logger = new LogLayer({
     consoleDebug: config.enableConsoleDebug ?? false,
@@ -46,7 +66,7 @@ export const createUILogger = function createUILogger(config: UILoggerConfig = {
   return new UILogger(logger);
 };
 
-export const createUILoggerWithCallback = function createUILoggerWithCallback(callback: (logEntry: any) => void, config: UILoggerConfig = {}): UILogger {
+export const createUILoggerWithCallback = function createUILoggerWithCallback(callback: (logEntry: LogEntry) => void, config: UILoggerConfig = {}): UILogger {
   const transport = new UILogTransport(callback);
   const logger = new LogLayer({
     consoleDebug: config.enableConsoleDebug ?? false,

package/src/utils/ui-logger.ts

@@ -22,12 +22,38 @@ import type { ILogLayer } from 'loglayer';
  * - Separate from debug logging avoids UI noise
  */
 
+interface ProtocolContext {
+  variables?: Map<string, unknown>;
+}
+
 /**
  * Generic protocol step interface for UI logging
  */
-export interface UIProtocolStep {
-  [key: string]: any;
-}
+export type UIProtocolStep = Record<string, unknown>;
+
+/**
+ * Type guards for protocol step properties
+ */
+const hasDescription = (obj: unknown): obj is { description: string } =>
+  typeof obj === 'object' && obj !== null && 'description' in obj && typeof (obj as Record<string, unknown>).description === 'string';
+
+const hasReceive = (obj: unknown): obj is { receive: unknown } => typeof obj === 'object' && obj !== null && 'receive' in obj;
+
+const hasEndChunk = (obj: unknown): obj is { endChunk: { receive: unknown } } =>
+  typeof obj === 'object' &&
+  obj !== null &&
+  'endChunk' in obj &&
+  typeof (obj as Record<string, unknown>).endChunk === 'object' &&
+  (obj as Record<string, unknown>).endChunk !== null &&
+  'receive' in ((obj as Record<string, unknown>).endChunk as Record<string, unknown>);
+
+const hasStartChunk = (obj: unknown): obj is { startChunk: { receive: unknown } } =>
+  typeof obj === 'object' &&
+  obj !== null &&
+  'startChunk' in obj &&
+  typeof (obj as Record<string, unknown>).startChunk === 'object' &&
+  (obj as Record<string, unknown>).startChunk !== null &&
+  'receive' in ((obj as Record<string, unknown>).startChunk as Record<string, unknown>);
 
 /**
  * UI Logger for capturing command-level information for UI display
@@ -63,7 +89,7 @@ export class UILogger {
   }
 
   // eslint-disable-next-line max-params
-  logCommandSuccess(stepIndex: number, totalSteps: number, operation: string, step: UIProtocolStep, context: any): void {
+  logCommandSuccess(stepIndex: number, totalSteps: number, operation: string, step: UIProtocolStep, context: ProtocolContext): void {
     const commandId = `${operation}-${stepIndex}`;
     const startTime = this.commandStartTimes.get(commandId) || Date.now();
     const endTime = Date.now();
@@ -73,20 +99,18 @@ export class UILogger {
     const description = this.getStepDescription(step);
 
     // Extract sent and received data from context
-    const dataSent = context.variables?.get('lastSentData');
-    const dataReceived = context.variables?.get('lastReceivedData');
+    const dataSent = context.variables && context.variables.get('lastSentData');
+    const dataReceived = context.variables && context.variables.get('lastReceivedData');
     const dataExpected = this.getExpectedData(step);
 
     // For readSegment, also extract chunk logs if present
-    let dataChunks = undefined;
-    if ('readSegment' === commandType) {
-      dataChunks = context.variables?.get('lastReadSegmentChunks');
-      // For readSegment, we don't need the flattened dataSent/dataReceived since we have dataChunks
-    }
+    const dataChunks = commandType === 'readSegment' && context.variables && context.variables.get('lastReadSegmentChunks');
 
     // Convert dataSent and dataReceived to byte array format if they exist
-    const dataSentArray = dataSent ? [...dataSent] : undefined;
-    const dataReceivedArray = dataReceived ? [...dataReceived] : undefined;
+    // eslint-disable-next-line unicorn/prefer-spread
+    const dataSentArray = dataSent && Array.from(dataSent as Uint8Array);
+    // eslint-disable-next-line unicorn/prefer-spread
+    const dataReceivedArray = dataReceived && Array.from(dataReceived as Uint8Array);
 
     this.logger
       .withMetadata({
@@ -108,7 +132,7 @@ export class UILogger {
   }
 
   // eslint-disable-next-line max-params
-  logCommandFailure(stepIndex: number, totalSteps: number, operation: string, step: UIProtocolStep, error: Error, context: any): void {
+  logCommandFailure(stepIndex: number, totalSteps: number, operation: string, step: UIProtocolStep, error: Error, context: ProtocolContext): void {
     const commandId = `${operation}-${stepIndex}`;
     const startTime = this.commandStartTimes.get(commandId) || Date.now();
     const endTime = Date.now();
@@ -118,11 +142,12 @@ export class UILogger {
     const description = this.getStepDescription(step);
 
     // Extract sent data from context
-    const dataSent = context.variables?.get('lastSentData');
+    const dataSent = context.variables && context.variables.get('lastSentData');
     const dataExpected = this.getExpectedData(step);
 
     // Convert dataSent to byte array format if it exists
-    const dataSentArray = dataSent ? [...dataSent] : undefined;
+    // eslint-disable-next-line unicorn/prefer-spread
+    const dataSentArray = dataSent && Array.from(dataSent as Uint8Array);
 
     this.logger
       .withMetadata({
@@ -165,26 +190,26 @@ export class UILogger {
   }
 
   private getStepDescription(step: UIProtocolStep): string {
-    if ('sendReceive' in step && step.sendReceive.description) {
+    if ('sendReceive' in step && hasDescription(step.sendReceive)) {
       return step.sendReceive.description;
     }
-    if ('send' in step && step.send.description) {
+    if ('send' in step && hasDescription(step.send)) {
       return step.send.description;
     }
-    if ('receive' in step && step.receive.description) {
+    if ('receive' in step && hasDescription(step.receive)) {
       return step.receive.description;
     }
-    if ('readSegment' in step && step.readSegment.description) {
+    if ('readSegment' in step && hasDescription(step.readSegment)) {
       return step.readSegment.description;
     }
-    if ('writeSegment' in step && step.writeSegment.description) {
+    if ('writeSegment' in step && hasDescription(step.writeSegment)) {
       return step.writeSegment.description;
     }
     return 'No description';
   }
 
-  private getExpectedData(step: UIProtocolStep): any {
-    if ('sendReceive' in step && step.sendReceive.receive) {
+  private getExpectedData(step: UIProtocolStep): unknown {
+    if ('sendReceive' in step && hasReceive(step.sendReceive)) {
       return step.sendReceive.receive;
     }
     if ('receive' in step) {
@@ -192,12 +217,15 @@ export class UILogger {
     }
     if ('readSegment' in step) {
       // For readSegment, return both start and end chunk receive patterns
-      return {
-        endChunk: step.readSegment.endChunk.receive,
-        startChunk: step.readSegment.startChunk.receive,
-        type: 'readSegment',
-      };
+      const { readSegment } = step;
+      if (hasEndChunk(readSegment) && hasStartChunk(readSegment)) {
+        return {
+          endChunk: readSegment.endChunk.receive,
+          startChunk: readSegment.startChunk.receive,
+          type: 'readSegment',
+        };
+      }
     }
-    return undefined;
+    return {};
   }
 }

package/dist/utils/memory-segment-utils.d.ts

@@ -1,3 +0,0 @@
-import type { RadioMemorySegment } from '@springfield/ham-radio-api';
-export declare const formatSegment: (segment: RadioMemorySegment) => string;
-//# sourceMappingURL=memory-segment-utils.d.ts.map

package/dist/utils/memory-segment-utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"memory-segment-utils.d.ts","sourceRoot":"","sources":["../../src/utils/memory-segment-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAIrE,eAAO,MAAM,aAAa,GAAI,SAAS,kBAAkB,KAAG,MAE3D,CAAC"}

package/dist/utils/memory-segment-utils.js

@@ -1,6 +0,0 @@
-import { sprintf } from 'sprintf-js';
-import { toHexWords } from './to-hex-words.js';
-export const formatSegment = (segment) => {
-    return sprintf('%04X : %s', segment.startAddress, toHexWords(segment.data));
-};
-//# sourceMappingURL=memory-segment-utils.js.map

package/dist/utils/memory-segment-utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"memory-segment-utils.js","sourceRoot":"","sources":["../../src/utils/memory-segment-utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAA2B,EAAU,EAAE;IACnE,OAAO,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,YAAY,EAAE,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AAC9E,CAAC,CAAC","sourcesContent":["import type { RadioMemorySegment } from '@springfield/ham-radio-api';\nimport { sprintf } from 'sprintf-js';\nimport { toHexWords } from './to-hex-words.js';\n\nexport const formatSegment = (segment: RadioMemorySegment): string => {\n  return sprintf('%04X : %s', segment.startAddress, toHexWords(segment.data));\n};\n"]}

package/src/utils/bcd-to-number.ts

@@ -1,10 +0,0 @@
-export const bcdToNumber = (data: Uint8Array, offset?: number, length?: number): number => {
-  let bcd = 0;
-  const size = length ?? data.length;
-
-  for (let i = offset ?? 0; i < size; i++) {
-    bcd |= data[i] << (8 * i);
-  }
-
-  return parseInt(bcd.toString(16), 10) * 10;
-};

package/src/utils/number-to-bcd.ts

@@ -1,15 +0,0 @@
-export const numberToBcd = (value: number): Uint8Array => {
-  const digits = value.toString(10);
-  const numberOfBytes = Math.ceil(digits.length / 2);
-
-  const data = new Uint8Array(numberOfBytes);
-
-  let bcd = parseInt(digits, 16);
-
-  for (let i = 0; i < numberOfBytes; i++) {
-    data[i] = bcd & 0xff;
-    bcd >>= 8;
-  }
-
-  return data;
-};