@springfield/ham-radio-utils 3.2.6 → 4.1.0

package/dist/index.d.ts

@@ -5,6 +5,7 @@ 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/operator-class-mapper.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,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"}
+{"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,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"}

package/dist/index.js

@@ -5,6 +5,7 @@ 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/operator-class-mapper.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,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"]}
+{"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,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","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/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' };\n"]}

package/dist/schemas/radio-protocol-schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "Radio Protocol DSL Schema",
-  "description": "Schema for defining radio communication protocols in a declarative JSON format",
+  "description": "Schema for defining radio communication protocols as send/expect exchanges",
   "type": "object",
   "required": [
     "id",
@@ -169,7 +169,7 @@
               },
               "endAddress": {
                 "type": "integer",
-                "description": "Ending address (inclusive) of the memory segment",
+                "description": "Inclusive ending address of the memory segment",
                 "minimum": 0
               }
             }
@@ -194,358 +194,192 @@
   },
   "definitions": {
     "protocolStep": {
-      "type": "object",
-      "description": "A single protocol step",
+      "description": "A single protocol step: an exchange, a chunked read, or a chunked write",
       "oneOf": [
         {
-          "type": "object",
-          "required": [
-            "sendReceive"
-          ],
-          "properties": {
-            "sendReceive": {
-              "$ref": "#/definitions/sendReceiveStep"
-            }
-          }
+          "$ref": "#/definitions/readStep"
         },
         {
-          "type": "object",
-          "required": [
-            "send"
-          ],
-          "properties": {
-            "send": {
-              "$ref": "#/definitions/sendStep"
-            }
-          }
+          "$ref": "#/definitions/writeStep"
         },
         {
-          "type": "object",
-          "required": [
-            "receive"
-          ],
-          "properties": {
-            "receive": {
-              "$ref": "#/definitions/receiveStep"
-            }
-          }
+          "$ref": "#/definitions/exchangeStep"
+        }
+      ]
+    },
+    "byteToken": {
+      "description": "A send/expect token: a byte, hex string (0x50), ASCII opcode (S), or placeholder ($address)",
+      "oneOf": [
+        {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 255
         },
         {
-          "type": "object",
-          "required": [
-            "readSegment"
-          ],
-          "properties": {
-            "readSegment": {
-              "$ref": "#/definitions/readSegmentStep"
-            }
-          }
+          "type": "string",
+          "minLength": 1
+        }
+      ]
+    },
+    "sendData": {
+      "type": "array",
+      "description": "Bytes and placeholders to send",
+      "items": {
+        "$ref": "#/definitions/byteToken"
+      }
+    },
+    "expect": {
+      "description": "Expected serial reply: exact byte(s), opaque length, or a framed pattern",
+      "oneOf": [
+        {
+          "$ref": "#/definitions/byteToken"
         },
         {
-          "type": "object",
-          "required": [
-            "writeSegment"
-          ],
-          "properties": {
-            "writeSegment": {
-              "$ref": "#/definitions/writeSegmentStep"
-            }
-          }
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/byteToken"
+          },
+          "minItems": 1
         },
         {
           "type": "object",
           "required": [
-            "setVariable"
+            "bytes"
           ],
+          "additionalProperties": false,
           "properties": {
-            "setVariable": {
-              "$ref": "#/definitions/setVariableStep"
+            "bytes": {
+              "type": "integer",
+              "description": "Accept any content of this many bytes",
+              "minimum": 1
             }
           }
         }
       ]
     },
-    "sendReceiveStep": {
+    "exchangeStep": {
       "type": "object",
-      "description": "Send data and receive response",
-      "required": [
-        "send",
-        "receive"
+      "description": "Send bytes and/or wait for a reply",
+      "anyOf": [
+        {
+          "required": [
+            "send"
+          ]
+        },
+        {
+          "required": [
+            "expect"
+          ]
+        }
       ],
+      "additionalProperties": false,
       "properties": {
+        "description": {
+          "type": "string",
+          "description": "Human-readable description of the step"
+        },
         "send": {
           "$ref": "#/definitions/sendData"
         },
-        "receive": {
-          "$ref": "#/definitions/receiveConfig"
+        "expect": {
+          "$ref": "#/definitions/expect"
         },
         "timeout": {
           "type": "integer",
           "description": "Timeout in milliseconds",
           "minimum": 1,
           "default": 5000
-        },
-        "description": {
-          "type": "string",
-          "description": "Human-readable description of the step"
         }
       }
     },
-    "sendStep": {
+    "readStep": {
       "type": "object",
-      "description": "Send data only",
+      "description": "Chunked memory read",
       "required": [
-        "data"
+        "read"
       ],
+      "additionalProperties": false,
       "properties": {
-        "data": {
-          "$ref": "#/definitions/sendData"
-        },
         "description": {
           "type": "string",
           "description": "Human-readable description of the step"
-        }
-      }
-    },
-    "receiveStep": {
-      "type": "object",
-      "description": "Receive data only",
-      "required": [
-        "type",
-        "length"
-      ],
-      "properties": {
-        "type": {
-          "type": "string",
-          "enum": [
-            "exact",
-            "variable",
-            "pattern",
-            "any"
-          ],
-          "description": "Type of receive operation"
-        },
-        "value": {
-          "type": "integer",
-          "description": "Expected value for exact match",
-          "minimum": 0,
-          "maximum": 255
-        },
-        "length": {
-          "type": "integer",
-          "description": "Expected length in bytes",
-          "minimum": 1
         },
-        "pattern": {
-          "type": "array",
-          "description": "Pattern for structured responses",
-          "items": {
-            "oneOf": [
-              {
-                "type": "string",
-                "description": "Literal value (1 byte)"
-              },
-              {
-                "type": "number",
-                "description": "Literal value (1 byte)"
+        "read": {
+          "type": "object",
+          "required": [
+            "segments",
+            "send",
+            "expect"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "segments": {
+              "type": "array",
+              "description": "Memory segment names to read",
+              "items": {
+                "type": "string"
               },
-              {
-                "type": "object",
-                "required": [
-                  "field",
-                  "size"
-                ],
-                "properties": {
-                  "field": {
-                    "type": "string",
-                    "description": "Field name for extracted data"
-                  },
-                  "size": {
-                    "type": "integer",
-                    "description": "Size in bytes (0 for variable length)",
-                    "minimum": 0
-                  }
-                }
-              }
-            ]
-          }
-        },
-        "description": {
-          "type": "string",
-          "description": "Human-readable description of the step"
-        }
-      }
-    },
-    "readSegmentStep": {
-      "type": "object",
-      "description": "Read memory segments",
-      "required": [
-        "segments",
-        "startChunk",
-        "endChunk"
-      ],
-      "properties": {
-        "segments": {
-          "type": "array",
-          "description": "List of segment names to read",
-          "items": {
-            "type": "string"
+              "minItems": 1
+            },
+            "send": {
+              "$ref": "#/definitions/sendData"
+            },
+            "expect": {
+              "$ref": "#/definitions/expect"
+            },
+            "ack": {
+              "$ref": "#/definitions/exchangeStep",
+              "description": "Optional exchange after each chunk"
+            },
+            "timeout": {
+              "type": "integer",
+              "description": "Timeout in milliseconds for each chunk exchange",
+              "minimum": 1
+            }
           }
-        },
-        "startChunk": {
-          "$ref": "#/definitions/sendReceiveStep",
-          "description": "Protocol for starting a chunk read"
-        },
-        "endChunk": {
-          "$ref": "#/definitions/sendReceiveStep",
-          "description": "Protocol for ending a chunk read"
-        },
-        "description": {
-          "type": "string",
-          "description": "Human-readable description of the step"
         }
       }
     },
-    "writeSegmentStep": {
+    "writeStep": {
       "type": "object",
-      "description": "Write memory segments",
+      "description": "Chunked memory write",
       "required": [
-        "segments",
-        "send",
-        "data",
-        "receive"
+        "write"
       ],
+      "additionalProperties": false,
       "properties": {
-        "segments": {
-          "type": "array",
-          "description": "List of segment names to write",
-          "items": {
-            "type": "string"
-          }
-        },
-        "send": {
-          "$ref": "#/definitions/sendData",
-          "description": "Data to send for write command"
-        },
-        "data": {
-          "type": "string",
-          "description": "Expression for segment data to write"
-        },
-        "receive": {
-          "$ref": "#/definitions/receiveConfig",
-          "description": "Expected response for write command"
-        },
         "description": {
           "type": "string",
           "description": "Human-readable description of the step"
-        }
-      }
-    },
-    "setVariableStep": {
-      "type": "object",
-      "description": "Set a variable value",
-      "required": [
-        "name",
-        "value"
-      ],
-      "properties": {
-        "name": {
-          "type": "string",
-          "description": "Variable name"
         },
-        "value": {
-          "oneOf": [
-            {
-              "type": "string",
-              "description": "Expression or literal value"
-            },
-            {
-              "type": "number",
-              "description": "Numeric value"
-            }
-          ],
-          "description": "Value to assign to the variable"
-        }
-      }
-    },
-    "sendData": {
-      "type": "array",
-      "description": "Array of data to send",
-      "items": {
-        "oneOf": [
-          {
-            "type": "string",
-            "description": "String literal or expression"
-          },
-          {
-            "type": "number",
-            "description": "Numeric literal or expression",
-            "minimum": 0,
-            "maximum": 255
-          }
-        ]
-      }
-    },
-    "receiveConfig": {
-      "type": "object",
-      "description": "Configuration for receiving data",
-      "required": [
-        "type"
-      ],
-      "properties": {
-        "type": {
-          "type": "string",
-          "enum": [
-            "exact",
-            "variable",
-            "pattern",
-            "any"
+        "write": {
+          "type": "object",
+          "required": [
+            "segments",
+            "send",
+            "expect"
           ],
-          "description": "Type of receive operation"
-        },
-        "value": {
-          "type": "integer",
-          "description": "Expected value for exact match",
-          "minimum": 0,
-          "maximum": 255
-        },
-        "length": {
-          "type": "integer",
-          "description": "Expected length in bytes",
-          "minimum": 1
-        },
-        "pattern": {
-          "type": "array",
-          "description": "Pattern for structured responses",
-          "items": {
-            "oneOf": [
-              {
-                "type": "string",
-                "description": "Literal value (1 byte)"
-              },
-              {
-                "type": "number",
-                "description": "Literal value (1 byte)"
+          "additionalProperties": false,
+          "properties": {
+            "segments": {
+              "type": "array",
+              "description": "Memory segment names to write",
+              "items": {
+                "type": "string"
               },
-              {
-                "type": "object",
-                "required": [
-                  "field",
-                  "size"
-                ],
-                "properties": {
-                  "field": {
-                    "type": "string",
-                    "description": "Field name for extracted data"
-                  },
-                  "size": {
-                    "type": "integer",
-                    "description": "Size in bytes (0 for variable length)",
-                    "minimum": 0
-                  }
-                }
-              }
-            ]
+              "minItems": 1
+            },
+            "send": {
+              "$ref": "#/definitions/sendData"
+            },
+            "expect": {
+              "$ref": "#/definitions/expect"
+            },
+            "timeout": {
+              "type": "integer",
+              "description": "Timeout in milliseconds for each chunk exchange",
+              "minimum": 1
+            }
           }
         }
       }

package/dist/utils/band-plan.d.ts

@@ -19,6 +19,17 @@ export declare class BandPlan {
      * @returns The license class with the given ID, or undefined if not found
      */
     findPrivilegeById(id: string): LicenseClass | undefined;
+    /**
+     * Returns whether the given license class may transmit on the frequency.
+     *
+     * Looks up the band that contains the frequency and checks that band's
+     * privileges list. Frequencies outside every known band return false.
+     *
+     * @param frequencyHz - Frequency in Hz
+     * @param licenseClassId - Springfield license-class ID
+     * @returns true when the class has privilege on that frequency
+     */
+    hasPrivilege(frequencyHz: number, licenseClassId: string): boolean;
 }
 export {};
 //# sourceMappingURL=band-plan.d.ts.map

package/dist/utils/band-plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"band-plan.d.ts","sourceRoot":"","sources":["../../src/utils/band-plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAI/D,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,cAAc,CAA4B;IAElD,cAGC;IAED;;;;OAIG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE/D;IAED;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEtD;CACF"}
+{"version":3,"file":"band-plan.d.ts","sourceRoot":"","sources":["../../src/utils/band-plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAI/D,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,cAAc,CAA4B;IAElD,cAGC;IAED;;;;OAIG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE/D;IAED;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEtD;IAED;;;;;;;;;OASG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAQjE;CACF"}

package/dist/utils/band-plan.js

@@ -23,5 +23,22 @@ export class BandPlan {
     findPrivilegeById(id) {
         return this.licenseClasses.get(id);
     }
+    /**
+     * Returns whether the given license class may transmit on the frequency.
+     *
+     * Looks up the band that contains the frequency and checks that band's
+     * privileges list. Frequencies outside every known band return false.
+     *
+     * @param frequencyHz - Frequency in Hz
+     * @param licenseClassId - Springfield license-class ID
+     * @returns true when the class has privilege on that frequency
+     */
+    hasPrivilege(frequencyHz, licenseClassId) {
+        const band = this.findBandByFrequency(frequencyHz);
+        if (!band) {
+            return false;
+        }
+        return band.privileges.includes(licenseClassId);
+    }
 }
 //# sourceMappingURL=band-plan.js.map

package/dist/utils/band-plan.js.map

@@ -1 +1 @@
-{"version":3,"file":"band-plan.js","sourceRoot":"","sources":["../../src/utils/band-plan.ts"],"names":[],"mappings":"AACA,OAAO,SAAS,MAAM,kBAAkB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC/D,OAAO,kBAAkB,MAAM,4BAA4B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAOlF,MAAM,OAAO,QAAQ;IACX,KAAK,CAAiB;IACtB,cAAc,CAA4B;IAElD;QACE,IAAI,CAAC,KAAK,GAAG,SAA2B,CAAC;QACzC,IAAI,CAAC,cAAc,GAAG,IAAI,GAAG,CAAE,kBAAqC,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/H,CAAC;IAED;;;;OAIG;IACH,mBAAmB,CAAC,SAAiB;QACnC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,IAAI,IAAI,CAAC,cAAc,IAAI,SAAS,IAAI,IAAI,CAAC,cAAc,CAAC,CAAC;IACzG,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,EAAU;QAC1B,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;CACF","sourcesContent":["import type { SpectrumBand } from '@springfield/ham-radio-api';\nimport bandsData from '../db/bands.json' with { type: 'json' };\nimport licenseClassesData from '../db/license-classes.json' with { type: 'json' };\n\ninterface LicenseClass {\n  id: string;\n  name: string;\n}\n\nexport class BandPlan {\n  private bands: SpectrumBand[];\n  private licenseClasses: Map<string, LicenseClass>;\n\n  constructor() {\n    this.bands = bandsData as SpectrumBand[];\n    this.licenseClasses = new Map((licenseClassesData as LicenseClass[]).map((licenseClass) => [licenseClass.id, licenseClass]));\n  }\n\n  /**\n   * Finds the spectrum band that contains the given frequency\n   * @param frequency The frequency in Hz to find the band for\n   * @returns The spectrum band containing the frequency, or undefined if no band contains it\n   */\n  findBandByFrequency(frequency: number): SpectrumBand | undefined {\n    return this.bands.find((band) => frequency >= band.lowerFrequency && frequency <= band.upperFrequency);\n  }\n\n  /**\n   * Finds a license class by its ID\n   * @param id The ID of the license class to find\n   * @returns The license class with the given ID, or undefined if not found\n   */\n  findPrivilegeById(id: string): LicenseClass | undefined {\n    return this.licenseClasses.get(id);\n  }\n}\n"]}
+{"version":3,"file":"band-plan.js","sourceRoot":"","sources":["../../src/utils/band-plan.ts"],"names":[],"mappings":"AACA,OAAO,SAAS,MAAM,kBAAkB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC/D,OAAO,kBAAkB,MAAM,4BAA4B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAOlF,MAAM,OAAO,QAAQ;IACX,KAAK,CAAiB;IACtB,cAAc,CAA4B;IAElD;QACE,IAAI,CAAC,KAAK,GAAG,SAA2B,CAAC;QACzC,IAAI,CAAC,cAAc,GAAG,IAAI,GAAG,CAAE,kBAAqC,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/H,CAAC;IAED;;;;OAIG;IACH,mBAAmB,CAAC,SAAiB;QACnC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,IAAI,IAAI,CAAC,cAAc,IAAI,SAAS,IAAI,IAAI,CAAC,cAAc,CAAC,CAAC;IACzG,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,EAAU;QAC1B,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;IAED;;;;;;;;;OASG;IACH,YAAY,CAAC,WAAmB,EAAE,cAAsB;QACtD,MAAM,IAAI,GAAG,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAEnD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAQ,IAAI,CAAC,UAAuB,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAChE,CAAC;CACF","sourcesContent":["import type { SpectrumBand } from '@springfield/ham-radio-api';\nimport bandsData from '../db/bands.json' with { type: 'json' };\nimport licenseClassesData from '../db/license-classes.json' with { type: 'json' };\n\ninterface LicenseClass {\n  id: string;\n  name: string;\n}\n\nexport class BandPlan {\n  private bands: SpectrumBand[];\n  private licenseClasses: Map<string, LicenseClass>;\n\n  constructor() {\n    this.bands = bandsData as SpectrumBand[];\n    this.licenseClasses = new Map((licenseClassesData as LicenseClass[]).map((licenseClass) => [licenseClass.id, licenseClass]));\n  }\n\n  /**\n   * Finds the spectrum band that contains the given frequency\n   * @param frequency The frequency in Hz to find the band for\n   * @returns The spectrum band containing the frequency, or undefined if no band contains it\n   */\n  findBandByFrequency(frequency: number): SpectrumBand | undefined {\n    return this.bands.find((band) => frequency >= band.lowerFrequency && frequency <= band.upperFrequency);\n  }\n\n  /**\n   * Finds a license class by its ID\n   * @param id The ID of the license class to find\n   * @returns The license class with the given ID, or undefined if not found\n   */\n  findPrivilegeById(id: string): LicenseClass | undefined {\n    return this.licenseClasses.get(id);\n  }\n\n  /**\n   * Returns whether the given license class may transmit on the frequency.\n   *\n   * Looks up the band that contains the frequency and checks that band's\n   * privileges list. Frequencies outside every known band return false.\n   *\n   * @param frequencyHz - Frequency in Hz\n   * @param licenseClassId - Springfield license-class ID\n   * @returns true when the class has privilege on that frequency\n   */\n  hasPrivilege(frequencyHz: number, licenseClassId: string): boolean {\n    const band = this.findBandByFrequency(frequencyHz);\n\n    if (!band) {\n      return false;\n    }\n\n    return (band.privileges as string[]).includes(licenseClassId);\n  }\n}\n"]}

package/dist/utils/operator-class-mapper.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Maps a Callook.info / FCC operator-class name to a Springfield license-class ID.
+ *
+ * Callook returns values such as TECHNICIAN, GENERAL, and EXTRA. Club, military,
+ * and RACES records often have an empty operator class and map to undefined.
+ *
+ * @param operClass - Operator class string from Callook or an equivalent FCC source
+ * @returns The matching license-class ID, or undefined when no personal class applies
+ */
+export declare function operatorClassToLicenseClassId(operClass: string): string | undefined;
+//# sourceMappingURL=operator-class-mapper.d.ts.map

package/dist/utils/operator-class-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator-class-mapper.d.ts","sourceRoot":"","sources":["../../src/utils/operator-class-mapper.ts"],"names":[],"mappings":"AAeA;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAuBnF"}

package/dist/utils/operator-class-mapper.js

@@ -0,0 +1,39 @@
+import licenseClassesData from '../db/license-classes.json' with { type: 'json' };
+const LICENSE_CLASSES = licenseClassesData;
+const TECHNICIAN_ID = LICENSE_CLASSES.find((licenseClass) => licenseClass.name === 'Technician').id;
+const GENERAL_ID = LICENSE_CLASSES.find((licenseClass) => licenseClass.name === 'General').id;
+const EXTRA_ID = LICENSE_CLASSES.find((licenseClass) => licenseClass.name === 'Amateur Extra').id;
+const ADVANCED_ID = LICENSE_CLASSES.find((licenseClass) => licenseClass.name === 'Advanced (Grandfathered)').id;
+const NOVICE_ID = LICENSE_CLASSES.find((licenseClass) => licenseClass.name === 'Novice (Grandfathered)').id;
+/**
+ * Maps a Callook.info / FCC operator-class name to a Springfield license-class ID.
+ *
+ * Callook returns values such as TECHNICIAN, GENERAL, and EXTRA. Club, military,
+ * and RACES records often have an empty operator class and map to undefined.
+ *
+ * @param operClass - Operator class string from Callook or an equivalent FCC source
+ * @returns The matching license-class ID, or undefined when no personal class applies
+ */
+export function operatorClassToLicenseClassId(operClass) {
+    const normalized = operClass.trim().toUpperCase().replace(/\s+/g, ' ');
+    if (normalized.length === 0) {
+        return undefined;
+    }
+    switch (normalized) {
+        case 'TECHNICIAN':
+        case 'TECHNICIAN PLUS':
+            return TECHNICIAN_ID;
+        case 'GENERAL':
+            return GENERAL_ID;
+        case 'EXTRA':
+        case 'AMATEUR EXTRA':
+            return EXTRA_ID;
+        case 'ADVANCED':
+            return ADVANCED_ID;
+        case 'NOVICE':
+            return NOVICE_ID;
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=operator-class-mapper.js.map