@springfield/ham-radio-utils 4.0.0 → 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/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

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

@@ -0,0 +1 @@
+{"version":3,"file":"operator-class-mapper.js","sourceRoot":"","sources":["../../src/utils/operator-class-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,MAAM,4BAA4B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAOlF,MAAM,eAAe,GAAG,kBAAoC,CAAC;AAE7D,MAAM,aAAa,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,KAAK,YAAY,CAAE,CAAC,EAAE,CAAC;AACrG,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,KAAK,SAAS,CAAE,CAAC,EAAE,CAAC;AAC/F,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,KAAK,eAAe,CAAE,CAAC,EAAE,CAAC;AACnG,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,KAAK,0BAA0B,CAAE,CAAC,EAAE,CAAC;AACjH,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,KAAK,wBAAwB,CAAE,CAAC,EAAE,CAAC;AAE7G;;;;;;;;GAQG;AACH,MAAM,UAAU,6BAA6B,CAAC,SAAiB;IAC7D,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEvE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,YAAY,CAAC;QAClB,KAAK,iBAAiB;YACpB,OAAO,aAAa,CAAC;QACvB,KAAK,SAAS;YACZ,OAAO,UAAU,CAAC;QACpB,KAAK,OAAO,CAAC;QACb,KAAK,eAAe;YAClB,OAAO,QAAQ,CAAC;QAClB,KAAK,UAAU;YACb,OAAO,WAAW,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC;QACnB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC","sourcesContent":["import licenseClassesData from '../db/license-classes.json' with { type: 'json' };\n\ninterface LicenseClass {\n  id: string;\n  name: string;\n}\n\nconst LICENSE_CLASSES = licenseClassesData as LicenseClass[];\n\nconst TECHNICIAN_ID = LICENSE_CLASSES.find((licenseClass) => licenseClass.name === 'Technician')!.id;\nconst GENERAL_ID = LICENSE_CLASSES.find((licenseClass) => licenseClass.name === 'General')!.id;\nconst EXTRA_ID = LICENSE_CLASSES.find((licenseClass) => licenseClass.name === 'Amateur Extra')!.id;\nconst ADVANCED_ID = LICENSE_CLASSES.find((licenseClass) => licenseClass.name === 'Advanced (Grandfathered)')!.id;\nconst NOVICE_ID = LICENSE_CLASSES.find((licenseClass) => licenseClass.name === 'Novice (Grandfathered)')!.id;\n\n/**\n * Maps a Callook.info / FCC operator-class name to a Springfield license-class ID.\n *\n * Callook returns values such as TECHNICIAN, GENERAL, and EXTRA. Club, military,\n * and RACES records often have an empty operator class and map to undefined.\n *\n * @param operClass - Operator class string from Callook or an equivalent FCC source\n * @returns The matching license-class ID, or undefined when no personal class applies\n */\nexport function operatorClassToLicenseClassId(operClass: string): string | undefined {\n  const normalized = operClass.trim().toUpperCase().replace(/\\s+/g, ' ');\n\n  if (normalized.length === 0) {\n    return undefined;\n  }\n\n  switch (normalized) {\n    case 'TECHNICIAN':\n    case 'TECHNICIAN PLUS':\n      return TECHNICIAN_ID;\n    case 'GENERAL':\n      return GENERAL_ID;\n    case 'EXTRA':\n    case 'AMATEUR EXTRA':\n      return EXTRA_ID;\n    case 'ADVANCED':\n      return ADVANCED_ID;\n    case 'NOVICE':\n      return NOVICE_ID;\n    default:\n      return undefined;\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@springfield/ham-radio-utils",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "author": "Bryan Hunt",
   "license": "MIT",
   "readme": "README.md",

package/src/index.ts

@@ -7,6 +7,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/src/utils/band-plan.ts

@@ -33,4 +33,24 @@ export class BandPlan {
   findPrivilegeById(id: string): LicenseClass | undefined {
     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: number, licenseClassId: string): boolean {
+    const band = this.findBandByFrequency(frequencyHz);
+
+    if (!band) {
+      return false;
+    }
+
+    return (band.privileges as string[]).includes(licenseClassId);
+  }
 }

package/src/utils/operator-class-mapper.ts

@@ -0,0 +1,48 @@
+import licenseClassesData from '../db/license-classes.json' with { type: 'json' };
+
+interface LicenseClass {
+  id: string;
+  name: string;
+}
+
+const LICENSE_CLASSES = licenseClassesData as LicenseClass[];
+
+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: string): string | undefined {
+  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;
+  }
+}