@springfield/ham-radio-registry 1.2.0 → 1.3.0

package/dist/catalog/index.d.ts

@@ -2,4 +2,5 @@ export { hydrateRadioConfig } from './hydrate-radio-config.js';
 export { extractCatalogMetadata } from './extract-catalog-metadata.js';
 export { validateConfiguration } from './validate-configuration.js';
 export { computeContentHash, hashRadioConfig } from './content-hash.js';
+export { validateModuleCatalog, parseModuleCatalog, compareSemver, isApiVersionCompatible, normalizeIntegrity, integrityFromSha256Hex, } from './module-catalog.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/catalog/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/catalog/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/catalog/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC"}

package/dist/catalog/index.js

@@ -2,4 +2,5 @@ export { hydrateRadioConfig } from './hydrate-radio-config.js';
 export { extractCatalogMetadata } from './extract-catalog-metadata.js';
 export { validateConfiguration } from './validate-configuration.js';
 export { computeContentHash, hashRadioConfig } from './content-hash.js';
+export { validateModuleCatalog, parseModuleCatalog, compareSemver, isApiVersionCompatible, normalizeIntegrity, integrityFromSha256Hex, } from './module-catalog.js';
 //# sourceMappingURL=index.js.map

package/dist/catalog/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/catalog/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/catalog/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC"}

package/dist/catalog/module-catalog.d.ts

@@ -0,0 +1,28 @@
+import type { CatalogValidationResult, RadioModuleCatalog } from '../types/module-catalog.js';
+/**
+ * Validate and normalize a catalog.json document.
+ */
+export declare function validateModuleCatalog(value: unknown): CatalogValidationResult & {
+    catalog?: RadioModuleCatalog;
+};
+/**
+ * Parse catalog JSON text and validate it.
+ */
+export declare function parseModuleCatalog(json: string): RadioModuleCatalog;
+/**
+ * Compare dotted semver-like versions. Returns negative if left < right, 0 if equal, positive if left > right.
+ */
+export declare function compareSemver(left: string, right: string): number;
+/**
+ * True when the installed API version satisfies the module's minimum.
+ */
+export declare function isApiVersionCompatible(installedApiVersion: string, minApiVersion: string): boolean;
+/**
+ * Normalize integrity strings for comparison (lowercase hex).
+ */
+export declare function normalizeIntegrity(integrity: string): string;
+/**
+ * Build a sha256 integrity string from a hex digest.
+ */
+export declare function integrityFromSha256Hex(hex: string): string;
+//# sourceMappingURL=module-catalog.d.ts.map

package/dist/catalog/module-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-catalog.d.ts","sourceRoot":"","sources":["../../src/catalog/module-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,kBAAkB,EAA2B,MAAM,4BAA4B,CAAC;AAqFvH;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,GAAG;IAAE,OAAO,CAAC,EAAE,kBAAkB,CAAA;CAAE,CAiDhH;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAiBnE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAejE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,mBAAmB,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAElG;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1D"}

package/dist/catalog/module-catalog.js

@@ -0,0 +1,164 @@
+const INTEGRITY_PATTERN = /^sha256:[a-fA-F0-9]{64}$/;
+const SUPPORTED_SCHEMA_VERSION = 1;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+function isHttpsUrl(value) {
+    try {
+        const url = new URL(value);
+        return url.protocol === 'https:';
+    }
+    catch {
+        return false;
+    }
+}
+function validateModuleEntry(entry, index, errors) {
+    if (!isRecord(entry)) {
+        errors.push(`modules[${index}] must be an object`);
+        return undefined;
+    }
+    const prefix = `modules[${index}]`;
+    if (!isNonEmptyString(entry.id)) {
+        errors.push(`${prefix}.id is required`);
+    }
+    if (!isNonEmptyString(entry.package)) {
+        errors.push(`${prefix}.package is required`);
+    }
+    if (!isNonEmptyString(entry.manufacturer)) {
+        errors.push(`${prefix}.manufacturer is required`);
+    }
+    if (!isNonEmptyString(entry.version)) {
+        errors.push(`${prefix}.version is required`);
+    }
+    if (!Array.isArray(entry.supportedRadios) || entry.supportedRadios.length === 0) {
+        errors.push(`${prefix}.supportedRadios must be a non-empty array`);
+    }
+    else if (!entry.supportedRadios.every((radio) => isNonEmptyString(radio))) {
+        errors.push(`${prefix}.supportedRadios must contain only non-empty strings`);
+    }
+    if (!isNonEmptyString(entry.minApiVersion)) {
+        errors.push(`${prefix}.minApiVersion is required`);
+    }
+    if (!isNonEmptyString(entry.downloadUrl) || !isHttpsUrl(entry.downloadUrl)) {
+        errors.push(`${prefix}.downloadUrl must be an https URL`);
+    }
+    if (!isNonEmptyString(entry.integrity) || !INTEGRITY_PATTERN.test(entry.integrity)) {
+        errors.push(`${prefix}.integrity must match sha256:<64 hex chars>`);
+    }
+    if (entry.description !== undefined && typeof entry.description !== 'string') {
+        errors.push(`${prefix}.description must be a string when present`);
+    }
+    if (errors.some((error) => error.startsWith(prefix))) {
+        return undefined;
+    }
+    return {
+        id: entry.id,
+        package: entry.package,
+        manufacturer: entry.manufacturer,
+        ...(typeof entry.description === 'string' ? { description: entry.description } : {}),
+        version: entry.version,
+        supportedRadios: entry.supportedRadios,
+        minApiVersion: entry.minApiVersion,
+        downloadUrl: entry.downloadUrl,
+        integrity: entry.integrity.toLowerCase(),
+    };
+}
+/**
+ * Validate and normalize a catalog.json document.
+ */
+export function validateModuleCatalog(value) {
+    const errors = [];
+    const warnings = [];
+    if (!isRecord(value)) {
+        return { isValid: false, errors: ['Catalog must be a JSON object'], warnings };
+    }
+    if (value.schemaVersion !== SUPPORTED_SCHEMA_VERSION) {
+        errors.push(`Unsupported schemaVersion: expected ${SUPPORTED_SCHEMA_VERSION}`);
+    }
+    if (!Array.isArray(value.modules)) {
+        errors.push('modules must be an array');
+        return { isValid: false, errors, warnings };
+    }
+    const modules = [];
+    const seenIds = new Set();
+    for (let index = 0; index < value.modules.length; index += 1) {
+        const entry = validateModuleEntry(value.modules[index], index, errors);
+        if (!entry) {
+            continue;
+        }
+        if (seenIds.has(entry.id)) {
+            errors.push(`Duplicate module id: ${entry.id}`);
+            continue;
+        }
+        seenIds.add(entry.id);
+        modules.push(entry);
+    }
+    if (errors.length > 0) {
+        return { isValid: false, errors, warnings };
+    }
+    return {
+        isValid: true,
+        errors,
+        warnings,
+        catalog: {
+            schemaVersion: SUPPORTED_SCHEMA_VERSION,
+            modules,
+        },
+    };
+}
+/**
+ * Parse catalog JSON text and validate it.
+ */
+export function parseModuleCatalog(json) {
+    let parsed;
+    try {
+        parsed = JSON.parse(json);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Invalid JSON';
+        throw new Error(`Failed to parse module catalog: ${message}`);
+    }
+    const result = validateModuleCatalog(parsed);
+    if (!result.isValid || !result.catalog) {
+        throw new Error(`Invalid module catalog: ${result.errors.join(', ')}`);
+    }
+    return result.catalog;
+}
+/**
+ * Compare dotted semver-like versions. Returns negative if left < right, 0 if equal, positive if left > right.
+ */
+export function compareSemver(left, right) {
+    const leftParts = left.split('.').map((part) => Number.parseInt(part, 10) || 0);
+    const rightParts = right.split('.').map((part) => Number.parseInt(part, 10) || 0);
+    const length = Math.max(leftParts.length, rightParts.length);
+    for (let index = 0; index < length; index += 1) {
+        const leftValue = leftParts[index] ?? 0;
+        const rightValue = rightParts[index] ?? 0;
+        if (leftValue !== rightValue) {
+            return leftValue - rightValue;
+        }
+    }
+    return 0;
+}
+/**
+ * True when the installed API version satisfies the module's minimum.
+ */
+export function isApiVersionCompatible(installedApiVersion, minApiVersion) {
+    return compareSemver(installedApiVersion, minApiVersion) >= 0;
+}
+/**
+ * Normalize integrity strings for comparison (lowercase hex).
+ */
+export function normalizeIntegrity(integrity) {
+    return integrity.trim().toLowerCase();
+}
+/**
+ * Build a sha256 integrity string from a hex digest.
+ */
+export function integrityFromSha256Hex(hex) {
+    return `sha256:${hex.trim().toLowerCase()}`;
+}
+//# sourceMappingURL=module-catalog.js.map

package/dist/catalog/module-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-catalog.js","sourceRoot":"","sources":["../../src/catalog/module-catalog.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export type { RadioConfigMetadata, RadioCapabilities, CodecConfig, RegistryRadio, RadioCatalogEntry, RadioCatalogSource, } from './types/radio-config.js';
+export type { RadioModuleCatalog, RadioModuleCatalogEntry, CatalogValidationResult, } from './types/module-catalog.js';
 export type { ValidationResult } from '@springfield/ham-radio-api';
 export type { PluginModule, PluginCapabilities, SpringfieldPluginConfig, NpmPluginInfo, PluginManifest, PluginManifestConfiguration, PluginSharedComponents, PluginSecurity, } from './types/plugin-module.js';
-export { hydrateRadioConfig, extractCatalogMetadata, validateConfiguration, computeContentHash, hashRadioConfig, } from './catalog/index.js';
+export { hydrateRadioConfig, extractCatalogMetadata, validateConfiguration, computeContentHash, hashRadioConfig, validateModuleCatalog, parseModuleCatalog, compareSemver, isApiVersionCompatible, normalizeIntegrity, integrityFromSha256Hex, } from './catalog/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAGjC,YAAY,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,uBAAuB,EACvB,aAAa,EACb,cAAc,EACd,2BAA2B,EAC3B,sBAAsB,EACtB,cAAc,GACf,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,GAChB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AAGnC,YAAY,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,uBAAuB,EACvB,aAAa,EACb,cAAc,EACd,2BAA2B,EAC3B,sBAAsB,EACtB,cAAc,GACf,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,3 +1,3 @@
 // Browser-safe catalog API (no node:fs)
-export { hydrateRadioConfig, extractCatalogMetadata, validateConfiguration, computeContentHash, hashRadioConfig, } from './catalog/index.js';
+export { hydrateRadioConfig, extractCatalogMetadata, validateConfiguration, computeContentHash, hashRadioConfig, validateModuleCatalog, parseModuleCatalog, compareSemver, isApiVersionCompatible, normalizeIntegrity, integrityFromSha256Hex, } from './catalog/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAwBA,wCAAwC;AACxC,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,GAChB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA8BA,wCAAwC;AACxC,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC"}

package/dist/types/module-catalog.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Official radio module catalog index (served via GitHub Pages).
+ */
+export interface RadioModuleCatalog {
+    schemaVersion: number;
+    modules: RadioModuleCatalogEntry[];
+}
+/**
+ * One installable official radio module listed in the catalog.
+ */
+export interface RadioModuleCatalogEntry {
+    id: string;
+    package: string;
+    manufacturer: string;
+    description?: string;
+    version: string;
+    supportedRadios: string[];
+    minApiVersion: string;
+    downloadUrl: string;
+    /** SHA-256 of the zip as `sha256:<hex>`. */
+    integrity: string;
+}
+export interface CatalogValidationResult {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+//# sourceMappingURL=module-catalog.d.ts.map

package/dist/types/module-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-catalog.d.ts","sourceRoot":"","sources":["../../src/types/module-catalog.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,uBAAuB,EAAE,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB"}

package/dist/types/module-catalog.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=module-catalog.js.map

package/dist/types/module-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-catalog.js","sourceRoot":"","sources":["../../src/types/module-catalog.ts"],"names":[],"mappings":""}

package/dist/types/radio-config.d.ts

@@ -39,7 +39,7 @@ export interface RegistryRadio extends Radio {
 /**
  * Source of a catalogued radio configuration
  */
-export type RadioCatalogSource = 'bundled' | 'user';
+export type RadioCatalogSource = 'bundled' | 'installed' | 'user';
 /**
  * Lightweight catalog metadata for listing radios (e.g. import dialog)
  */

package/dist/types/radio-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"radio-config.d.ts","sourceRoot":"","sources":["../../src/types/radio-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,KAAK;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,iBAAiB,CAAC;IAChC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,mBAAmB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,MAAM,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,iBAAiB,CAAC;IAChC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"radio-config.d.ts","sourceRoot":"","sources":["../../src/types/radio-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,KAAK;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,iBAAiB,CAAC;IAChC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,mBAAmB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,iBAAiB,CAAC;IAChC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/package.json

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

package/src/catalog/index.ts

@@ -2,3 +2,11 @@ export { hydrateRadioConfig } from './hydrate-radio-config.js';
 export { extractCatalogMetadata } from './extract-catalog-metadata.js';
 export { validateConfiguration } from './validate-configuration.js';
 export { computeContentHash, hashRadioConfig } from './content-hash.js';
+export {
+  validateModuleCatalog,
+  parseModuleCatalog,
+  compareSemver,
+  isApiVersionCompatible,
+  normalizeIntegrity,
+  integrityFromSha256Hex,
+} from './module-catalog.js';

package/src/catalog/module-catalog.ts

@@ -0,0 +1,201 @@
+import type { CatalogValidationResult, RadioModuleCatalog, RadioModuleCatalogEntry } from '../types/module-catalog.js';
+
+const INTEGRITY_PATTERN = /^sha256:[a-fA-F0-9]{64}$/;
+const SUPPORTED_SCHEMA_VERSION = 1;
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+function isNonEmptyString(value: unknown): value is string {
+  return typeof value === 'string' && value.trim().length > 0;
+}
+
+function isHttpsUrl(value: string): boolean {
+  try {
+    const url = new URL(value);
+    return url.protocol === 'https:';
+  } catch {
+    return false;
+  }
+}
+
+function validateModuleEntry(entry: unknown, index: number, errors: string[]): RadioModuleCatalogEntry | undefined {
+  if (!isRecord(entry)) {
+    errors.push(`modules[${index}] must be an object`);
+    return undefined;
+  }
+
+  const prefix = `modules[${index}]`;
+
+  if (!isNonEmptyString(entry.id)) {
+    errors.push(`${prefix}.id is required`);
+  }
+
+  if (!isNonEmptyString(entry.package)) {
+    errors.push(`${prefix}.package is required`);
+  }
+
+  if (!isNonEmptyString(entry.manufacturer)) {
+    errors.push(`${prefix}.manufacturer is required`);
+  }
+
+  if (!isNonEmptyString(entry.version)) {
+    errors.push(`${prefix}.version is required`);
+  }
+
+  if (!Array.isArray(entry.supportedRadios) || entry.supportedRadios.length === 0) {
+    errors.push(`${prefix}.supportedRadios must be a non-empty array`);
+  } else if (!entry.supportedRadios.every((radio) => isNonEmptyString(radio))) {
+    errors.push(`${prefix}.supportedRadios must contain only non-empty strings`);
+  }
+
+  if (!isNonEmptyString(entry.minApiVersion)) {
+    errors.push(`${prefix}.minApiVersion is required`);
+  }
+
+  if (!isNonEmptyString(entry.downloadUrl) || !isHttpsUrl(entry.downloadUrl)) {
+    errors.push(`${prefix}.downloadUrl must be an https URL`);
+  }
+
+  if (!isNonEmptyString(entry.integrity) || !INTEGRITY_PATTERN.test(entry.integrity)) {
+    errors.push(`${prefix}.integrity must match sha256:<64 hex chars>`);
+  }
+
+  if (entry.description !== undefined && typeof entry.description !== 'string') {
+    errors.push(`${prefix}.description must be a string when present`);
+  }
+
+  if (errors.some((error) => error.startsWith(prefix))) {
+    return undefined;
+  }
+
+  return {
+    id: entry.id as string,
+    package: entry.package as string,
+    manufacturer: entry.manufacturer as string,
+    ...(typeof entry.description === 'string' ? { description: entry.description } : {}),
+    version: entry.version as string,
+    supportedRadios: entry.supportedRadios as string[],
+    minApiVersion: entry.minApiVersion as string,
+    downloadUrl: entry.downloadUrl as string,
+    integrity: (entry.integrity as string).toLowerCase(),
+  };
+}
+
+/**
+ * Validate and normalize a catalog.json document.
+ */
+export function validateModuleCatalog(value: unknown): CatalogValidationResult & { catalog?: RadioModuleCatalog } {
+  const errors: string[] = [];
+  const warnings: string[] = [];
+
+  if (!isRecord(value)) {
+    return { isValid: false, errors: ['Catalog must be a JSON object'], warnings };
+  }
+
+  if (value.schemaVersion !== SUPPORTED_SCHEMA_VERSION) {
+    errors.push(`Unsupported schemaVersion: expected ${SUPPORTED_SCHEMA_VERSION}`);
+  }
+
+  if (!Array.isArray(value.modules)) {
+    errors.push('modules must be an array');
+    return { isValid: false, errors, warnings };
+  }
+
+  const modules: RadioModuleCatalogEntry[] = [];
+  const seenIds = new Set<string>();
+
+  for (let index = 0; index < value.modules.length; index += 1) {
+    const entry = validateModuleEntry(value.modules[index], index, errors);
+
+    if (!entry) {
+      continue;
+    }
+
+    if (seenIds.has(entry.id)) {
+      errors.push(`Duplicate module id: ${entry.id}`);
+      continue;
+    }
+
+    seenIds.add(entry.id);
+    modules.push(entry);
+  }
+
+  if (errors.length > 0) {
+    return { isValid: false, errors, warnings };
+  }
+
+  return {
+    isValid: true,
+    errors,
+    warnings,
+    catalog: {
+      schemaVersion: SUPPORTED_SCHEMA_VERSION,
+      modules,
+    },
+  };
+}
+
+/**
+ * Parse catalog JSON text and validate it.
+ */
+export function parseModuleCatalog(json: string): RadioModuleCatalog {
+  let parsed: unknown;
+
+  try {
+    parsed = JSON.parse(json);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : 'Invalid JSON';
+    throw new Error(`Failed to parse module catalog: ${message}`);
+  }
+
+  const result = validateModuleCatalog(parsed);
+
+  if (!result.isValid || !result.catalog) {
+    throw new Error(`Invalid module catalog: ${result.errors.join(', ')}`);
+  }
+
+  return result.catalog;
+}
+
+/**
+ * Compare dotted semver-like versions. Returns negative if left < right, 0 if equal, positive if left > right.
+ */
+export function compareSemver(left: string, right: string): number {
+  const leftParts = left.split('.').map((part) => Number.parseInt(part, 10) || 0);
+  const rightParts = right.split('.').map((part) => Number.parseInt(part, 10) || 0);
+  const length = Math.max(leftParts.length, rightParts.length);
+
+  for (let index = 0; index < length; index += 1) {
+    const leftValue = leftParts[index] ?? 0;
+    const rightValue = rightParts[index] ?? 0;
+
+    if (leftValue !== rightValue) {
+      return leftValue - rightValue;
+    }
+  }
+
+  return 0;
+}
+
+/**
+ * True when the installed API version satisfies the module's minimum.
+ */
+export function isApiVersionCompatible(installedApiVersion: string, minApiVersion: string): boolean {
+  return compareSemver(installedApiVersion, minApiVersion) >= 0;
+}
+
+/**
+ * Normalize integrity strings for comparison (lowercase hex).
+ */
+export function normalizeIntegrity(integrity: string): string {
+  return integrity.trim().toLowerCase();
+}
+
+/**
+ * Build a sha256 integrity string from a hex digest.
+ */
+export function integrityFromSha256Hex(hex: string): string {
+  return `sha256:${hex.trim().toLowerCase()}`;
+}

package/src/index.ts

@@ -8,6 +8,12 @@ export type {
   RadioCatalogSource,
 } from './types/radio-config.js';
 
+export type {
+  RadioModuleCatalog,
+  RadioModuleCatalogEntry,
+  CatalogValidationResult,
+} from './types/module-catalog.js';
+
 // Re-export common types from ham-radio-api
 export type { ValidationResult } from '@springfield/ham-radio-api';
 
@@ -29,4 +35,10 @@ export {
   validateConfiguration,
   computeContentHash,
   hashRadioConfig,
+  validateModuleCatalog,
+  parseModuleCatalog,
+  compareSemver,
+  isApiVersionCompatible,
+  normalizeIntegrity,
+  integrityFromSha256Hex,
 } from './catalog/index.js';

package/src/types/module-catalog.ts

@@ -0,0 +1,29 @@
+/**
+ * Official radio module catalog index (served via GitHub Pages).
+ */
+export interface RadioModuleCatalog {
+  schemaVersion: number;
+  modules: RadioModuleCatalogEntry[];
+}
+
+/**
+ * One installable official radio module listed in the catalog.
+ */
+export interface RadioModuleCatalogEntry {
+  id: string;
+  package: string;
+  manufacturer: string;
+  description?: string;
+  version: string;
+  supportedRadios: string[];
+  minApiVersion: string;
+  downloadUrl: string;
+  /** SHA-256 of the zip as `sha256:<hex>`. */
+  integrity: string;
+}
+
+export interface CatalogValidationResult {
+  isValid: boolean;
+  errors: string[];
+  warnings: string[];
+}

package/src/types/radio-config.ts

@@ -44,7 +44,7 @@ export interface RegistryRadio extends Radio {
 /**
  * Source of a catalogued radio configuration
  */
-export type RadioCatalogSource = 'bundled' | 'user';
+export type RadioCatalogSource = 'bundled' | 'installed' | 'user';
 
 /**
  * Lightweight catalog metadata for listing radios (e.g. import dialog)