@springfield/ham-radio-utils 4.5.0 → 4.6.0

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export * from './memory/segmented-memory.js';
 export * from './memory/memory-map-codec.js';
 export * from './memory/memory-map-channels.js';
 export * from './memory/memory-map-ui.js';
+export * from './memory/memory-map-radio-codec.js';
 export * from './test-utils/radio-channel-factory.js';
 export * from './test-utils/radio-programmed-channel-factory.js';
 export * from './utils/band-plan.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;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAE1C,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,kCAAkC,CAAC;AACjD,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;AAC5G,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,wCAAwC,CAAuB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oCAAoC,CAAC;AAEnD,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,kCAAkC,CAAC;AACjD,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;AAC5G,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,wCAAwC,CAAuB"}

package/dist/index.js

@@ -2,6 +2,7 @@ export * from './memory/segmented-memory.js';
 export * from './memory/memory-map-codec.js';
 export * from './memory/memory-map-channels.js';
 export * from './memory/memory-map-ui.js';
+export * from './memory/memory-map-radio-codec.js';
 export * from './test-utils/radio-channel-factory.js';
 export * from './test-utils/radio-programmed-channel-factory.js';
 export * from './utils/band-plan.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAE1C,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,kCAAkC,CAAC;AACjD,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;AAC5G,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,wCAAwC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC","sourcesContent":["export * from './memory/segmented-memory.js';\nexport * from './memory/memory-map-codec.js';\nexport * from './memory/memory-map-channels.js';\nexport * from './memory/memory-map-ui.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/operator-class-mapper.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' };\nexport { default as radioMemoryMapSchema } from './schemas/radio-memory-map-schema.json' with { type: 'json' };\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oCAAoC,CAAC;AAEnD,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,kCAAkC,CAAC;AACjD,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;AAC5G,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,wCAAwC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC","sourcesContent":["export * from './memory/segmented-memory.js';\nexport * from './memory/memory-map-codec.js';\nexport * from './memory/memory-map-channels.js';\nexport * from './memory/memory-map-ui.js';\nexport * from './memory/memory-map-radio-codec.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/operator-class-mapper.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' };\nexport { default as radioMemoryMapSchema } from './schemas/radio-memory-map-schema.json' with { type: 'json' };\n"]}

package/dist/memory/memory-map-radio-codec.d.ts

@@ -0,0 +1,34 @@
+import type { RadioCodec, RadioMemory, RadioMemoryConfig, RadioMemoryMap, RadioModelId, RadioProgram } from '@springfield/ham-radio-api';
+import type { ILogLayer } from 'loglayer';
+/**
+ * Compute the sparse image size that covers every configured memory segment.
+ */
+export declare function memoryImageSize(memoryConfig: RadioMemoryConfig): number;
+/**
+ * Create a Chirp-like empty EEPROM image filled with 0xFF.
+ */
+export declare function createEmptyMemoryImage(totalSize: number): Uint8Array;
+export interface MemoryMapRadioCodecOptions {
+    radioModel: RadioModelId;
+    memoryMap: RadioMemoryMap;
+    memoryConfig: RadioMemoryConfig;
+    logger?: ILogLayer;
+}
+/**
+ * Generic RadioCodec driven entirely by a JSON memory map + memoryConfig.
+ * Radio modules that ship DSL JSON do not need TypeScript codecs.
+ */
+export declare class MemoryMapRadioCodec implements RadioCodec {
+    private readonly radioModel;
+    private readonly memoryMap;
+    private readonly memoryConfig;
+    private readonly logger;
+    constructor(options: MemoryMapRadioCodecOptions);
+    decode(memory: RadioMemory): RadioProgram;
+    encode(program: RadioProgram, memory: RadioMemory): RadioMemory;
+}
+/**
+ * Create a memory-map codec from hydrated radio config fields.
+ */
+export declare function createMemoryMapCodec(options: MemoryMapRadioCodecOptions): RadioCodec;
+//# sourceMappingURL=memory-map-radio-codec.d.ts.map

package/dist/memory/memory-map-radio-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-map-radio-codec.d.ts","sourceRoot":"","sources":["../../src/memory/memory-map-radio-codec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,YAAY,EACb,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG1C;;GAEG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,iBAAiB,GAAG,MAAM,CAGvE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAIpE;AAED,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,YAAY,CAAC;IACzB,SAAS,EAAE,cAAc,CAAC;IAC1B,YAAY,EAAE,iBAAiB,CAAC;IAChC,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,UAAU;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAe;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoB;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAE/C,YAAY,OAAO,EAAE,0BAA0B,EAK9C;IAED,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,YAAY,CAOxC;IAED,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,GAAG,WAAW,CA0B9D;CACF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,0BAA0B,GAAG,UAAU,CAEpF"}

package/dist/memory/memory-map-radio-codec.js

@@ -0,0 +1,72 @@
+import { decodeRadioProgram, encodeRadioProgram } from './memory-map-channels.js';
+/**
+ * Compute the sparse image size that covers every configured memory segment.
+ */
+export function memoryImageSize(memoryConfig) {
+    const ends = Object.values(memoryConfig.segments).map((segment) => segment.endAddress);
+    return Math.max(...ends) + 1;
+}
+/**
+ * Create a Chirp-like empty EEPROM image filled with 0xFF.
+ */
+export function createEmptyMemoryImage(totalSize) {
+    const memory = new Uint8Array(totalSize);
+    memory.fill(0xff);
+    return memory;
+}
+/**
+ * Generic RadioCodec driven entirely by a JSON memory map + memoryConfig.
+ * Radio modules that ship DSL JSON do not need TypeScript codecs.
+ */
+export class MemoryMapRadioCodec {
+    radioModel;
+    memoryMap;
+    memoryConfig;
+    logger;
+    constructor(options) {
+        this.radioModel = options.radioModel;
+        this.memoryMap = options.memoryMap;
+        this.memoryConfig = options.memoryConfig;
+        this.logger = options.logger;
+    }
+    decode(memory) {
+        try {
+            return decodeRadioProgram(this.memoryMap, memory.contents, this.memoryConfig);
+        }
+        catch (error) {
+            this.logger?.withError(error).warn('Failed to decode radio program from memory map');
+            return { channels: [], settings: {} };
+        }
+    }
+    encode(program, memory) {
+        const totalSize = memoryImageSize(this.memoryConfig);
+        const contents = memory.contents.length > 0 ? new Uint8Array(memory.contents) : createEmptyMemoryImage(totalSize);
+        if (contents.length < totalSize) {
+            const expanded = createEmptyMemoryImage(totalSize);
+            expanded.set(contents);
+            try {
+                encodeRadioProgram(this.memoryMap, program, expanded, this.memoryConfig);
+            }
+            catch (error) {
+                this.logger?.withError(error).warn('Failed to encode radio program into memory map');
+            }
+            this.logger?.debug(`Memory size: ${expanded.length} bytes`);
+            return { contents: expanded, radioModel: this.radioModel };
+        }
+        try {
+            encodeRadioProgram(this.memoryMap, program, contents, this.memoryConfig);
+        }
+        catch (error) {
+            this.logger?.withError(error).warn('Failed to encode radio program into memory map');
+        }
+        this.logger?.debug(`Memory size: ${contents.length} bytes`);
+        return { contents, radioModel: this.radioModel };
+    }
+}
+/**
+ * Create a memory-map codec from hydrated radio config fields.
+ */
+export function createMemoryMapCodec(options) {
+    return new MemoryMapRadioCodec(options);
+}
+//# sourceMappingURL=memory-map-radio-codec.js.map

package/dist/memory/memory-map-radio-codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-map-radio-codec.js","sourceRoot":"","sources":["../../src/memory/memory-map-radio-codec.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  RadioCodec,\n  RadioMemory,\n  RadioMemoryConfig,\n  RadioMemoryMap,\n  RadioModelId,\n  RadioProgram,\n} from '@springfield/ham-radio-api';\nimport type { ILogLayer } from 'loglayer';\nimport { decodeRadioProgram, encodeRadioProgram } from './memory-map-channels.js';\n\n/**\n * Compute the sparse image size that covers every configured memory segment.\n */\nexport function memoryImageSize(memoryConfig: RadioMemoryConfig): number {\n  const ends = Object.values(memoryConfig.segments).map((segment) => segment.endAddress);\n  return Math.max(...ends) + 1;\n}\n\n/**\n * Create a Chirp-like empty EEPROM image filled with 0xFF.\n */\nexport function createEmptyMemoryImage(totalSize: number): Uint8Array {\n  const memory = new Uint8Array(totalSize);\n  memory.fill(0xff);\n  return memory;\n}\n\nexport interface MemoryMapRadioCodecOptions {\n  radioModel: RadioModelId;\n  memoryMap: RadioMemoryMap;\n  memoryConfig: RadioMemoryConfig;\n  logger?: ILogLayer;\n}\n\n/**\n * Generic RadioCodec driven entirely by a JSON memory map + memoryConfig.\n * Radio modules that ship DSL JSON do not need TypeScript codecs.\n */\nexport class MemoryMapRadioCodec implements RadioCodec {\n  private readonly radioModel: RadioModelId;\n  private readonly memoryMap: RadioMemoryMap;\n  private readonly memoryConfig: RadioMemoryConfig;\n  private readonly logger: ILogLayer | undefined;\n\n  constructor(options: MemoryMapRadioCodecOptions) {\n    this.radioModel = options.radioModel;\n    this.memoryMap = options.memoryMap;\n    this.memoryConfig = options.memoryConfig;\n    this.logger = options.logger;\n  }\n\n  decode(memory: RadioMemory): RadioProgram {\n    try {\n      return decodeRadioProgram(this.memoryMap, memory.contents, this.memoryConfig);\n    } catch (error) {\n      this.logger?.withError(error).warn('Failed to decode radio program from memory map');\n      return { channels: [], settings: {} };\n    }\n  }\n\n  encode(program: RadioProgram, memory: RadioMemory): RadioMemory {\n    const totalSize = memoryImageSize(this.memoryConfig);\n    const contents =\n      memory.contents.length > 0 ? new Uint8Array(memory.contents) : createEmptyMemoryImage(totalSize);\n\n    if (contents.length < totalSize) {\n      const expanded = createEmptyMemoryImage(totalSize);\n      expanded.set(contents);\n      try {\n        encodeRadioProgram(this.memoryMap, program, expanded, this.memoryConfig);\n      } catch (error) {\n        this.logger?.withError(error).warn('Failed to encode radio program into memory map');\n      }\n\n      this.logger?.debug(`Memory size: ${expanded.length} bytes`);\n      return { contents: expanded, radioModel: this.radioModel };\n    }\n\n    try {\n      encodeRadioProgram(this.memoryMap, program, contents, this.memoryConfig);\n    } catch (error) {\n      this.logger?.withError(error).warn('Failed to encode radio program into memory map');\n    }\n\n    this.logger?.debug(`Memory size: ${contents.length} bytes`);\n    return { contents, radioModel: this.radioModel };\n  }\n}\n\n/**\n * Create a memory-map codec from hydrated radio config fields.\n */\nexport function createMemoryMapCodec(options: MemoryMapRadioCodecOptions): RadioCodec {\n  return new MemoryMapRadioCodec(options);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@springfield/ham-radio-utils",
-  "version": "4.5.0",
+  "version": "4.6.0",
   "author": "Bryan Hunt",
   "license": "MIT",
   "readme": "README.md",
@@ -30,7 +30,7 @@
     "test:unit": "tsx --test test/unit/**/*.test.ts"
   },
   "dependencies": {
-    "@springfield/ham-radio-api": "^17.2.0",
+    "@springfield/ham-radio-api": "^17.3.0",
     "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1",
     "fishery": "^2.4.0",

package/src/index.ts

@@ -2,6 +2,7 @@ export * from './memory/segmented-memory.js';
 export * from './memory/memory-map-codec.js';
 export * from './memory/memory-map-channels.js';
 export * from './memory/memory-map-ui.js';
+export * from './memory/memory-map-radio-codec.js';
 
 export * from './test-utils/radio-channel-factory.js';
 export * from './test-utils/radio-programmed-channel-factory.js';

package/src/memory/memory-map-radio-codec.ts

@@ -0,0 +1,96 @@
+import type {
+  RadioCodec,
+  RadioMemory,
+  RadioMemoryConfig,
+  RadioMemoryMap,
+  RadioModelId,
+  RadioProgram,
+} from '@springfield/ham-radio-api';
+import type { ILogLayer } from 'loglayer';
+import { decodeRadioProgram, encodeRadioProgram } from './memory-map-channels.js';
+
+/**
+ * Compute the sparse image size that covers every configured memory segment.
+ */
+export function memoryImageSize(memoryConfig: RadioMemoryConfig): number {
+  const ends = Object.values(memoryConfig.segments).map((segment) => segment.endAddress);
+  return Math.max(...ends) + 1;
+}
+
+/**
+ * Create a Chirp-like empty EEPROM image filled with 0xFF.
+ */
+export function createEmptyMemoryImage(totalSize: number): Uint8Array {
+  const memory = new Uint8Array(totalSize);
+  memory.fill(0xff);
+  return memory;
+}
+
+export interface MemoryMapRadioCodecOptions {
+  radioModel: RadioModelId;
+  memoryMap: RadioMemoryMap;
+  memoryConfig: RadioMemoryConfig;
+  logger?: ILogLayer;
+}
+
+/**
+ * Generic RadioCodec driven entirely by a JSON memory map + memoryConfig.
+ * Radio modules that ship DSL JSON do not need TypeScript codecs.
+ */
+export class MemoryMapRadioCodec implements RadioCodec {
+  private readonly radioModel: RadioModelId;
+  private readonly memoryMap: RadioMemoryMap;
+  private readonly memoryConfig: RadioMemoryConfig;
+  private readonly logger: ILogLayer | undefined;
+
+  constructor(options: MemoryMapRadioCodecOptions) {
+    this.radioModel = options.radioModel;
+    this.memoryMap = options.memoryMap;
+    this.memoryConfig = options.memoryConfig;
+    this.logger = options.logger;
+  }
+
+  decode(memory: RadioMemory): RadioProgram {
+    try {
+      return decodeRadioProgram(this.memoryMap, memory.contents, this.memoryConfig);
+    } catch (error) {
+      this.logger?.withError(error).warn('Failed to decode radio program from memory map');
+      return { channels: [], settings: {} };
+    }
+  }
+
+  encode(program: RadioProgram, memory: RadioMemory): RadioMemory {
+    const totalSize = memoryImageSize(this.memoryConfig);
+    const contents =
+      memory.contents.length > 0 ? new Uint8Array(memory.contents) : createEmptyMemoryImage(totalSize);
+
+    if (contents.length < totalSize) {
+      const expanded = createEmptyMemoryImage(totalSize);
+      expanded.set(contents);
+      try {
+        encodeRadioProgram(this.memoryMap, program, expanded, this.memoryConfig);
+      } catch (error) {
+        this.logger?.withError(error).warn('Failed to encode radio program into memory map');
+      }
+
+      this.logger?.debug(`Memory size: ${expanded.length} bytes`);
+      return { contents: expanded, radioModel: this.radioModel };
+    }
+
+    try {
+      encodeRadioProgram(this.memoryMap, program, contents, this.memoryConfig);
+    } catch (error) {
+      this.logger?.withError(error).warn('Failed to encode radio program into memory map');
+    }
+
+    this.logger?.debug(`Memory size: ${contents.length} bytes`);
+    return { contents, radioModel: this.radioModel };
+  }
+}
+
+/**
+ * Create a memory-map codec from hydrated radio config fields.
+ */
+export function createMemoryMapCodec(options: MemoryMapRadioCodecOptions): RadioCodec {
+  return new MemoryMapRadioCodec(options);
+}