@springfield/ham-radio-utils 4.16.1 → 4.17.0

package/README.md

@@ -2,7 +2,21 @@
 
 Shared utilities for HamBench: memory-map codec, band plan, Callook license-class mapping, schema validation, and test helpers.
 
-Docs: [HamBench developer docs](https://springfield-ham-radio.github.io/ham-radio-docs/developer/) · [License lookup](https://springfield-ham-radio.github.io/ham-radio-docs/developer/license-lookup.html)
+Docs: [HamBench developer docs](https://springfield-ham-radio.github.io/ham-radio-docs/developer/) · [License lookup](https://springfield-ham-radio.github.io/ham-radio-docs/developer/license-lookup.html) · [Build a beta driver](https://springfield-ham-radio.github.io/ham-radio-docs/developer/beta-driver.html)
+
+## Beta driver zips
+
+`ham-radio-pack-beta` builds one local beta zip from a radio module working tree ([ADR 0010](https://github.com/springfield-ham-radio/ham-radio-docs/blob/main/docs/developer/adr/0010-local-beta-driver-zips.md)). It does not publish a release or write a catalog entry.
+
+From a manufacturer module repo, after this package is installed:
+
+```bash
+yarn pack:beta <modelId> [n]
+```
+
+`modelId` matches `configs/<modelId>.json`. `n` defaults to `1` (positive integer, no leading zero). The working-tree `version` and `minApiVersion` stay strict `major.minor.patch`. The zip is `dist-release/radio-module-<modelId>-<version>-beta.<n>.zip`, and the config inside the zip uses `<version>-beta.<n>`.
+
+Stdout is the zip path, size in bytes, a `sha256:` digest, and `git rev-parse --short HEAD` when the module tree is a git checkout. A beta of the same `major.minor.patch` as the catalog is older than that catalog release (`compareToCatalogVersion`).
 
 ## License
 

package/dist/index.d.ts

@@ -14,6 +14,8 @@ export * from './utils/schema-validator.js';
 export * from './utils/to-hex-words.js';
 export * from './utils/ui-logger.js';
 export * from './utils/ui-logger-factory.js';
+export { BETA_COUNTER_PATTERN, BETA_VERSION_PATTERN, MAX_BETA_ZIP_BYTES, STRICT_SEMVER_PATTERN, assertStrictSemver, closurePathsForConfig, compareDriverVersions, compareToCatalogVersion, expectedBetaZipName, formatBetaPackOutput, listConfigDescriptors, packBetaZip, packedBetaVersion, parseBetaCounter, parseConfigDescriptor, runPackBetaCli, shortGitSha, stageClosureWithBetaVersion, validateBetaDescriptor, } from './pack/pack-beta.js';
+export type { PackBetaCliIo, PackBetaOptions, PackBetaResult, RadioModuleConfigDescriptor } from './pack/pack-beta.js';
 export { default as radioProtocolSchema } from './schemas/radio-protocol-schema.json';
 export { default as radioMemoryMapSchema } from './schemas/radio-memory-map-schema.json';
 //# 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":"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"}
+{"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;AAE7C,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,WAAW,EACX,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAGvH,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,sCAAsC,CAAuB;AAC5G,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,wCAAwC,CAAuB"}

package/dist/index.js

@@ -14,6 +14,7 @@ export * from './utils/schema-validator.js';
 export * from './utils/to-hex-words.js';
 export * from './utils/ui-logger.js';
 export * from './utils/ui-logger-factory.js';
+export { BETA_COUNTER_PATTERN, BETA_VERSION_PATTERN, MAX_BETA_ZIP_BYTES, STRICT_SEMVER_PATTERN, assertStrictSemver, closurePathsForConfig, compareDriverVersions, compareToCatalogVersion, expectedBetaZipName, formatBetaPackOutput, listConfigDescriptors, packBetaZip, packedBetaVersion, parseBetaCounter, parseConfigDescriptor, runPackBetaCli, shortGitSha, stageClosureWithBetaVersion, validateBetaDescriptor, } from './pack/pack-beta.js';
 // Export the radio protocol schema
 export { default as radioProtocolSchema } from './schemas/radio-protocol-schema.json' with { type: 'json' };
 export { default as radioMemoryMapSchema } from './schemas/radio-memory-map-schema.json' with { type: 'json' };

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;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"]}
+{"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,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,WAAW,EACX,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAG7B,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\nexport {\n  BETA_COUNTER_PATTERN,\n  BETA_VERSION_PATTERN,\n  MAX_BETA_ZIP_BYTES,\n  STRICT_SEMVER_PATTERN,\n  assertStrictSemver,\n  closurePathsForConfig,\n  compareDriverVersions,\n  compareToCatalogVersion,\n  expectedBetaZipName,\n  formatBetaPackOutput,\n  listConfigDescriptors,\n  packBetaZip,\n  packedBetaVersion,\n  parseBetaCounter,\n  parseConfigDescriptor,\n  runPackBetaCli,\n  shortGitSha,\n  stageClosureWithBetaVersion,\n  validateBetaDescriptor,\n} from './pack/pack-beta.js';\nexport type { PackBetaCliIo, PackBetaOptions, PackBetaResult, RadioModuleConfigDescriptor } from './pack/pack-beta.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/pack/driver-semver.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Driver version precedence for local beta zips against a strict catalog version.
+ * ADR 0010: registry `compareSemver` stays numeric-only. This helper is the
+ * prerelease rule HamBench applies to install directories.
+ *
+ * - `1.11.1-beta.1` is older than catalog `1.11.1`
+ * - `1.11.2-beta.1` is newer than catalog `1.11.1`
+ * - among betas, `n` is numeric (`2` is less than `10`)
+ */
+export declare const STRICT_SEMVER_PATTERN: RegExp;
+export declare const BETA_COUNTER_PATTERN: RegExp;
+export declare const BETA_VERSION_PATTERN: RegExp;
+export interface ParsedDriverVersion {
+    major: number;
+    minor: number;
+    patch: number;
+    beta?: number;
+}
+export declare function assertStrictSemver(value: string, fieldLabel: string): void;
+export declare function parseBetaCounter(raw: string | undefined): number;
+export declare function packedBetaVersion(baseVersion: string, n: number): string;
+export declare function parseDriverVersion(version: string): ParsedDriverVersion;
+/**
+ * Positive when `left` is newer than `right`.
+ * A release is newer than a beta of the same major.minor.patch.
+ */
+export declare function compareDriverVersions(left: string, right: string): number;
+/**
+ * Compare an installed driver version to a catalog `major.minor.patch`.
+ * Catalog strings are strict; prerelease catalog versions are rejected.
+ * Negative means the install is older than the catalog entry (HamBench offers Update).
+ */
+export declare function compareToCatalogVersion(installedVersion: string, catalogVersion: string): number;
+//# sourceMappingURL=driver-semver.d.ts.map

package/dist/pack/driver-semver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-semver.d.ts","sourceRoot":"","sources":["../../src/pack/driver-semver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,qBAAqB,QAAoB,CAAC;AACvD,eAAO,MAAM,oBAAoB,QAAe,CAAC;AACjD,eAAO,MAAM,oBAAoB,QAA2C,CAAC;AAE7E,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAI1E;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAUhE;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAoBvE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA6BzE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,gBAAgB,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAMhG"}

package/dist/pack/driver-semver.js

@@ -0,0 +1,85 @@
+/**
+ * Driver version precedence for local beta zips against a strict catalog version.
+ * ADR 0010: registry `compareSemver` stays numeric-only. This helper is the
+ * prerelease rule HamBench applies to install directories.
+ *
+ * - `1.11.1-beta.1` is older than catalog `1.11.1`
+ * - `1.11.2-beta.1` is newer than catalog `1.11.1`
+ * - among betas, `n` is numeric (`2` is less than `10`)
+ */
+export const STRICT_SEMVER_PATTERN = /^\d+\.\d+\.\d+$/;
+export const BETA_COUNTER_PATTERN = /^[1-9]\d*$/;
+export const BETA_VERSION_PATTERN = /^(\d+)\.(\d+)\.(\d+)-beta\.([1-9]\d*)$/;
+export function assertStrictSemver(value, fieldLabel) {
+    if (!STRICT_SEMVER_PATTERN.test(value)) {
+        throw new Error(`${fieldLabel} must be strict major.minor.patch (no prerelease or build metadata)`);
+    }
+}
+export function parseBetaCounter(raw) {
+    if (raw === undefined) {
+        return 1;
+    }
+    if (!BETA_COUNTER_PATTERN.test(raw)) {
+        throw new Error('beta counter n must be a positive integer with no leading zero');
+    }
+    return Number(raw);
+}
+export function packedBetaVersion(baseVersion, n) {
+    return `${baseVersion}-beta.${n}`;
+}
+export function parseDriverVersion(version) {
+    const trimmed = version.trim();
+    const betaMatch = BETA_VERSION_PATTERN.exec(trimmed);
+    if (betaMatch) {
+        return {
+            major: Number(betaMatch[1]),
+            minor: Number(betaMatch[2]),
+            patch: Number(betaMatch[3]),
+            beta: Number(betaMatch[4]),
+        };
+    }
+    if (!STRICT_SEMVER_PATTERN.test(trimmed)) {
+        throw new Error(`driver version must be strict major.minor.patch or major.minor.patch-beta.n: ${version}`);
+    }
+    const [major, minor, patch] = trimmed.split('.').map((part) => Number(part));
+    return { major: major ?? 0, minor: minor ?? 0, patch: patch ?? 0 };
+}
+/**
+ * Positive when `left` is newer than `right`.
+ * A release is newer than a beta of the same major.minor.patch.
+ */
+export function compareDriverVersions(left, right) {
+    const a = parseDriverVersion(left);
+    const b = parseDriverVersion(right);
+    if (a.major !== b.major) {
+        return a.major - b.major;
+    }
+    if (a.minor !== b.minor) {
+        return a.minor - b.minor;
+    }
+    if (a.patch !== b.patch) {
+        return a.patch - b.patch;
+    }
+    if (a.beta === undefined && b.beta === undefined) {
+        return 0;
+    }
+    if (a.beta === undefined) {
+        return 1;
+    }
+    if (b.beta === undefined) {
+        return -1;
+    }
+    return a.beta - b.beta;
+}
+/**
+ * Compare an installed driver version to a catalog `major.minor.patch`.
+ * Catalog strings are strict; prerelease catalog versions are rejected.
+ * Negative means the install is older than the catalog entry (HamBench offers Update).
+ */
+export function compareToCatalogVersion(installedVersion, catalogVersion) {
+    if (!STRICT_SEMVER_PATTERN.test(catalogVersion)) {
+        throw new Error(`catalog version must be strict major.minor.patch: ${catalogVersion}`);
+    }
+    return compareDriverVersions(installedVersion, catalogVersion);
+}
+//# sourceMappingURL=driver-semver.js.map

package/dist/pack/driver-semver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-semver.js","sourceRoot":"","sources":["../../src/pack/driver-semver.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Driver version precedence for local beta zips against a strict catalog version.\n * ADR 0010: registry `compareSemver` stays numeric-only. This helper is the\n * prerelease rule HamBench applies to install directories.\n *\n * - `1.11.1-beta.1` is older than catalog `1.11.1`\n * - `1.11.2-beta.1` is newer than catalog `1.11.1`\n * - among betas, `n` is numeric (`2` is less than `10`)\n */\n\nexport const STRICT_SEMVER_PATTERN = /^\\d+\\.\\d+\\.\\d+$/;\nexport const BETA_COUNTER_PATTERN = /^[1-9]\\d*$/;\nexport const BETA_VERSION_PATTERN = /^(\\d+)\\.(\\d+)\\.(\\d+)-beta\\.([1-9]\\d*)$/;\n\nexport interface ParsedDriverVersion {\n  major: number;\n  minor: number;\n  patch: number;\n  beta?: number;\n}\n\nexport function assertStrictSemver(value: string, fieldLabel: string): void {\n  if (!STRICT_SEMVER_PATTERN.test(value)) {\n    throw new Error(`${fieldLabel} must be strict major.minor.patch (no prerelease or build metadata)`);\n  }\n}\n\nexport function parseBetaCounter(raw: string | undefined): number {\n  if (raw === undefined) {\n    return 1;\n  }\n\n  if (!BETA_COUNTER_PATTERN.test(raw)) {\n    throw new Error('beta counter n must be a positive integer with no leading zero');\n  }\n\n  return Number(raw);\n}\n\nexport function packedBetaVersion(baseVersion: string, n: number): string {\n  return `${baseVersion}-beta.${n}`;\n}\n\nexport function parseDriverVersion(version: string): ParsedDriverVersion {\n  const trimmed = version.trim();\n  const betaMatch = BETA_VERSION_PATTERN.exec(trimmed);\n\n  if (betaMatch) {\n    return {\n      major: Number(betaMatch[1]),\n      minor: Number(betaMatch[2]),\n      patch: Number(betaMatch[3]),\n      beta: Number(betaMatch[4]),\n    };\n  }\n\n  if (!STRICT_SEMVER_PATTERN.test(trimmed)) {\n    throw new Error(`driver version must be strict major.minor.patch or major.minor.patch-beta.n: ${version}`);\n  }\n\n  const [major, minor, patch] = trimmed.split('.').map((part) => Number(part));\n\n  return { major: major ?? 0, minor: minor ?? 0, patch: patch ?? 0 };\n}\n\n/**\n * Positive when `left` is newer than `right`.\n * A release is newer than a beta of the same major.minor.patch.\n */\nexport function compareDriverVersions(left: string, right: string): number {\n  const a = parseDriverVersion(left);\n  const b = parseDriverVersion(right);\n\n  if (a.major !== b.major) {\n    return a.major - b.major;\n  }\n\n  if (a.minor !== b.minor) {\n    return a.minor - b.minor;\n  }\n\n  if (a.patch !== b.patch) {\n    return a.patch - b.patch;\n  }\n\n  if (a.beta === undefined && b.beta === undefined) {\n    return 0;\n  }\n\n  if (a.beta === undefined) {\n    return 1;\n  }\n\n  if (b.beta === undefined) {\n    return -1;\n  }\n\n  return a.beta - b.beta;\n}\n\n/**\n * Compare an installed driver version to a catalog `major.minor.patch`.\n * Catalog strings are strict; prerelease catalog versions are rejected.\n * Negative means the install is older than the catalog entry (HamBench offers Update).\n */\nexport function compareToCatalogVersion(installedVersion: string, catalogVersion: string): number {\n  if (!STRICT_SEMVER_PATTERN.test(catalogVersion)) {\n    throw new Error(`catalog version must be strict major.minor.patch: ${catalogVersion}`);\n  }\n\n  return compareDriverVersions(installedVersion, catalogVersion);\n}\n"]}

package/dist/pack/pack-beta-cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=pack-beta-cli.d.ts.map

package/dist/pack/pack-beta-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-beta-cli.d.ts","sourceRoot":"","sources":["../../src/pack/pack-beta-cli.ts"],"names":[],"mappings":""}

package/dist/pack/pack-beta-cli.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { runPackBetaCli } from './pack-beta.js';
+const exitCode = runPackBetaCli(process.argv.slice(2), process.cwd());
+process.exit(exitCode);
+//# sourceMappingURL=pack-beta-cli.js.map

package/dist/pack/pack-beta-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-beta-cli.js","sourceRoot":"","sources":["../../src/pack/pack-beta-cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AACtE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\nimport { runPackBetaCli } from './pack-beta.js';\n\nconst exitCode = runPackBetaCli(process.argv.slice(2), process.cwd());\nprocess.exit(exitCode);\n"]}

package/dist/pack/pack-beta.d.ts

@@ -0,0 +1,39 @@
+export { assertStrictSemver, BETA_COUNTER_PATTERN, BETA_VERSION_PATTERN, compareDriverVersions, compareToCatalogVersion, packedBetaVersion, parseBetaCounter, STRICT_SEMVER_PATTERN, } from './driver-semver.js';
+export declare const MAX_BETA_ZIP_BYTES: number;
+export interface RadioModuleConfigDescriptor {
+    fileName: string;
+    relativeConfig: string;
+    modelId: string;
+    name: string;
+    configVersion: string;
+    minApiVersion: string;
+    manufacturer: string;
+    parsed: unknown;
+}
+export interface PackBetaOptions {
+    outputDirectory?: string;
+}
+export interface PackBetaResult {
+    zipPath: string;
+    zipName: string;
+    modelId: string;
+    baseVersion: string;
+    packedVersion: string;
+    size: number;
+    sha256: string;
+    gitSha?: string;
+}
+export declare function expectedBetaZipName(modelId: string, baseVersion: string, n: number): string;
+export declare function packBetaZip(moduleRoot: string, modelId: string, n?: number, options?: PackBetaOptions): PackBetaResult;
+export declare function validateBetaDescriptor(descriptor: Pick<RadioModuleConfigDescriptor, 'relativeConfig' | 'configVersion' | 'minApiVersion'>): void;
+export declare function listConfigDescriptors(moduleRoot: string): RadioModuleConfigDescriptor[];
+export declare function parseConfigDescriptor(moduleRoot: string, fileName: string, manufacturerDefault?: string): RadioModuleConfigDescriptor;
+export declare function closurePathsForConfig(moduleRoot: string, descriptor: Pick<RadioModuleConfigDescriptor, 'relativeConfig'>): string[];
+export declare function stageClosureWithBetaVersion(moduleRoot: string, stagingRoot: string, relativePaths: string[], configRelative: string, version: string): void;
+export declare function shortGitSha(moduleRoot: string): string | undefined;
+export declare function formatBetaPackOutput(result: Pick<PackBetaResult, 'zipPath' | 'size' | 'sha256' | 'gitSha'>): string;
+export interface PackBetaCliIo {
+    write(chunk: string): void;
+}
+export declare function runPackBetaCli(args: readonly string[], moduleRoot: string, stdout?: PackBetaCliIo, stderr?: PackBetaCliIo): number;
+//# sourceMappingURL=pack-beta.d.ts.map

package/dist/pack/pack-beta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-beta.d.ts","sourceRoot":"","sources":["../../src/pack/pack-beta.ts"],"names":[],"mappings":"AAkBA,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAE5B,eAAO,MAAM,kBAAkB,QAAc,CAAC;AAE9C,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3F;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,SAAI,EAAE,OAAO,GAAE,eAAoB,GAAG,cAAc,CA6CrH;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,IAAI,CAAC,2BAA2B,EAAE,gBAAgB,GAAG,eAAe,GAAG,eAAe,CAAC,GAAG,IAAI,CAsBhJ;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,2BAA2B,EAAE,CAavF;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,mBAAmB,CAAC,EAAE,MAAM,GAAG,2BAA2B,CAuDrI;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,2BAA2B,EAAE,gBAAgB,CAAC,GAAG,MAAM,EAAE,CAUnI;AAED,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAe3J;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAYlE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC,GAAG,MAAM,CAQnH;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAE,aAA8B,EAAE,MAAM,GAAE,aAA8B,GAAG,MAAM,CAiBlK"}

package/dist/pack/pack-beta.js

@@ -0,0 +1,242 @@
+/**
+ * Build one local beta driver zip (ADR 0010).
+ *
+ * Usage from a radio module repo: `yarn pack:beta <modelId> [n]`
+ *   n — positive beta counter (default 1, no leading zero).
+ *
+ * Writes `dist-release/radio-module-<modelId>-<version>-beta.<n>.zip` without
+ * modifying the working tree, catalog entries, or other zips in `dist-release/`.
+ * Does not call GitHub and does not skip a model that already has a release asset.
+ */
+import { createHash } from 'node:crypto';
+import { spawnSync } from 'node:child_process';
+import { cpSync, existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, rmSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { collectRefClosure } from './ref-closure.js';
+import { assertStrictSemver, BETA_COUNTER_PATTERN, packedBetaVersion, parseBetaCounter } from './driver-semver.js';
+export { assertStrictSemver, BETA_COUNTER_PATTERN, BETA_VERSION_PATTERN, compareDriverVersions, compareToCatalogVersion, packedBetaVersion, parseBetaCounter, STRICT_SEMVER_PATTERN, } from './driver-semver.js';
+export const MAX_BETA_ZIP_BYTES = 1024 * 1024;
+export function expectedBetaZipName(modelId, baseVersion, n) {
+    return `radio-module-${modelId}-${baseVersion}-beta.${n}.zip`;
+}
+export function packBetaZip(moduleRoot, modelId, n = 1, options = {}) {
+    if (!Number.isSafeInteger(n) || !BETA_COUNTER_PATTERN.test(String(n))) {
+        throw new Error('beta counter n must be a positive integer with no leading zero');
+    }
+    const descriptor = loadDescriptor(moduleRoot, modelId);
+    validateBetaDescriptor(descriptor);
+    const pathsToZip = closurePathsForConfig(moduleRoot, descriptor);
+    const version = packedBetaVersion(descriptor.configVersion, n);
+    const zipName = expectedBetaZipName(descriptor.modelId, descriptor.configVersion, n);
+    const outputDirectory = options.outputDirectory ?? join(moduleRoot, 'dist-release');
+    const zipPath = join(outputDirectory, zipName);
+    mkdirSync(outputDirectory, { recursive: true });
+    const stagingRoot = mkdtempSync(join(tmpdir(), 'pack-beta-'));
+    try {
+        stageClosureWithBetaVersion(moduleRoot, stagingRoot, pathsToZip, descriptor.relativeConfig, version);
+        createZipFromStaging(stagingRoot, zipPath, pathsToZip);
+    }
+    finally {
+        rmSync(stagingRoot, { recursive: true, force: true });
+    }
+    const size = statSync(zipPath).size;
+    if (size > MAX_BETA_ZIP_BYTES) {
+        unlinkSync(zipPath);
+        throw new Error(`beta zip exceeds ${MAX_BETA_ZIP_BYTES} bytes (${size} bytes)`);
+    }
+    const sha256 = integrityFromFile(zipPath);
+    const gitSha = shortGitSha(moduleRoot);
+    return {
+        zipPath,
+        zipName,
+        modelId: descriptor.modelId,
+        baseVersion: descriptor.configVersion,
+        packedVersion: version,
+        size,
+        sha256,
+        ...(gitSha ? { gitSha } : {}),
+    };
+}
+export function validateBetaDescriptor(descriptor) {
+    const { relativeConfig, configVersion, minApiVersion } = descriptor;
+    if (typeof configVersion !== 'string' || configVersion.length === 0) {
+        throw new Error(`${relativeConfig} is missing version`);
+    }
+    if (configVersion.includes('-') || configVersion.includes('+')) {
+        throw new Error(`${relativeConfig} version must not include a prerelease or build metadata suffix`);
+    }
+    assertStrictSemver(configVersion, `${relativeConfig} version`);
+    if (typeof minApiVersion !== 'string' || minApiVersion.length === 0) {
+        throw new Error(`${relativeConfig} is missing minApiVersion`);
+    }
+    if (minApiVersion.includes('-') || minApiVersion.includes('+')) {
+        throw new Error(`${relativeConfig} minApiVersion must not include a prerelease or build metadata suffix`);
+    }
+    assertStrictSemver(minApiVersion, `${relativeConfig} minApiVersion`);
+}
+export function listConfigDescriptors(moduleRoot) {
+    const configDirectory = join(moduleRoot, 'configs');
+    if (!existsSync(configDirectory)) {
+        throw new Error('configs directory is missing');
+    }
+    const manufacturerDefault = readManufacturerDefault(moduleRoot);
+    return readdirSync(configDirectory)
+        .filter((fileName) => fileName.endsWith('.json'))
+        .sort()
+        .map((fileName) => parseConfigDescriptor(moduleRoot, fileName, manufacturerDefault));
+}
+export function parseConfigDescriptor(moduleRoot, fileName, manufacturerDefault) {
+    const relativeConfig = `configs/${fileName}`;
+    const absoluteConfig = join(moduleRoot, relativeConfig);
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(absoluteConfig, 'utf8'));
+    }
+    catch {
+        throw new Error(`${relativeConfig} is not valid JSON`);
+    }
+    const record = parsed && typeof parsed === 'object' ? parsed : {};
+    const id = record.id && typeof record.id === 'object' ? record.id : {};
+    const modelId = id.model;
+    const name = id.name;
+    const configVersion = record.version;
+    const minApiVersion = record.minApiVersion;
+    const manufacturer = typeof id.manufacturer === 'string' && id.manufacturer.length > 0 ? id.manufacturer : manufacturerDefault;
+    if (typeof modelId !== 'string' || modelId.length === 0) {
+        throw new Error(`${relativeConfig} is missing id.model`);
+    }
+    if (typeof name !== 'string' || name.length === 0) {
+        throw new Error(`${relativeConfig} is missing id.name`);
+    }
+    if (typeof configVersion !== 'string' || configVersion.length === 0) {
+        throw new Error(`${relativeConfig} is missing version`);
+    }
+    if (typeof minApiVersion !== 'string' || minApiVersion.length === 0) {
+        throw new Error(`${relativeConfig} is missing minApiVersion`);
+    }
+    if (typeof manufacturer !== 'string' || manufacturer.length === 0) {
+        throw new Error(`${relativeConfig} is missing id.manufacturer`);
+    }
+    const expectedFile = `configs/${modelId}.json`;
+    if (relativeConfig !== expectedFile) {
+        throw new Error(`${relativeConfig} must be named ${expectedFile} (id.model ${modelId})`);
+    }
+    return {
+        fileName,
+        relativeConfig,
+        modelId,
+        name,
+        configVersion,
+        minApiVersion,
+        manufacturer,
+        parsed,
+    };
+}
+export function closurePathsForConfig(moduleRoot, descriptor) {
+    const paths = collectRefClosure(moduleRoot, descriptor.relativeConfig);
+    for (const relativePath of paths) {
+        if (!existsSync(join(moduleRoot, relativePath))) {
+            throw new Error(`${descriptor.relativeConfig} $ref target is missing: ${relativePath}`);
+        }
+    }
+    return paths;
+}
+export function stageClosureWithBetaVersion(moduleRoot, stagingRoot, relativePaths, configRelative, version) {
+    for (const relativePath of relativePaths) {
+        const sourcePath = join(moduleRoot, relativePath);
+        const destPath = join(stagingRoot, relativePath);
+        mkdirSync(dirname(destPath), { recursive: true });
+        if (relativePath === configRelative) {
+            const parsed = JSON.parse(readFileSync(sourcePath, 'utf8'));
+            parsed.version = version;
+            writeFileSync(destPath, `${JSON.stringify(parsed, null, 2)}\n`);
+        }
+        else {
+            cpSync(sourcePath, destPath);
+        }
+    }
+}
+export function shortGitSha(moduleRoot) {
+    const result = spawnSync('git', ['rev-parse', '--short', 'HEAD'], {
+        cwd: moduleRoot,
+        encoding: 'utf8',
+    });
+    if (result.status !== 0) {
+        return undefined;
+    }
+    const sha = result.stdout.trim();
+    return sha.length > 0 ? sha : undefined;
+}
+export function formatBetaPackOutput(result) {
+    const lines = [result.zipPath, String(result.size), result.sha256];
+    if (result.gitSha) {
+        lines.push(result.gitSha);
+    }
+    return `${lines.join('\n')}\n`;
+}
+export function runPackBetaCli(args, moduleRoot, stdout = process.stdout, stderr = process.stderr) {
+    const [modelId, nArg, ...rest] = args;
+    if (!modelId || rest.length > 0) {
+        stderr.write('usage: yarn pack:beta <modelId> [n]\n');
+        return 1;
+    }
+    try {
+        const n = parseBetaCounter(nArg);
+        const result = packBetaZip(moduleRoot, modelId, n);
+        stdout.write(formatBetaPackOutput(result));
+        return 0;
+    }
+    catch (error) {
+        stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+        return 1;
+    }
+}
+function loadDescriptor(moduleRoot, modelId) {
+    const descriptors = listConfigDescriptors(moduleRoot);
+    const descriptor = descriptors.find((entry) => entry.modelId === modelId);
+    if (!descriptor) {
+        const known = descriptors.map((entry) => entry.modelId).join(', ');
+        throw new Error(`unknown modelId ${modelId}; expected one of: ${known}`);
+    }
+    return descriptor;
+}
+function readManufacturerDefault(moduleRoot) {
+    const packagePath = join(moduleRoot, 'package.json');
+    if (!existsSync(packagePath)) {
+        return undefined;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(packagePath, 'utf8'));
+    }
+    catch {
+        throw new Error('package.json is not valid JSON');
+    }
+    if (!parsed || typeof parsed !== 'object') {
+        return undefined;
+    }
+    const springfield = parsed.springfield;
+    if (!springfield || typeof springfield !== 'object') {
+        return undefined;
+    }
+    const manufacturer = springfield.manufacturer;
+    return typeof manufacturer === 'string' && manufacturer.length > 0 ? manufacturer : undefined;
+}
+function createZipFromStaging(stagingRoot, zipPath, relativePaths) {
+    if (existsSync(zipPath)) {
+        unlinkSync(zipPath);
+    }
+    const zipResult = spawnSync('zip', ['-q', zipPath, ...relativePaths, '-x', '*.DS_Store'], {
+        cwd: stagingRoot,
+        encoding: 'utf8',
+    });
+    if (zipResult.status !== 0) {
+        throw new Error(zipResult.stderr || zipResult.stdout || 'zip failed');
+    }
+}
+function integrityFromFile(filePath) {
+    const hash = createHash('sha256').update(readFileSync(filePath)).digest('hex');
+    return `sha256:${hash}`;
+}
+//# sourceMappingURL=pack-beta.js.map

package/dist/pack/pack-beta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-beta.js","sourceRoot":"","sources":["../../src/pack/pack-beta.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Build one local beta driver zip (ADR 0010).\n *\n * Usage from a radio module repo: `yarn pack:beta <modelId> [n]`\n *   n — positive beta counter (default 1, no leading zero).\n *\n * Writes `dist-release/radio-module-<modelId>-<version>-beta.<n>.zip` without\n * modifying the working tree, catalog entries, or other zips in `dist-release/`.\n * Does not call GitHub and does not skip a model that already has a release asset.\n */\nimport { createHash } from 'node:crypto';\nimport { spawnSync } from 'node:child_process';\nimport { cpSync, existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, rmSync, statSync, unlinkSync, writeFileSync } from 'node:fs';\nimport { tmpdir } from 'node:os';\nimport { dirname, join } from 'node:path';\nimport { collectRefClosure } from './ref-closure.js';\nimport { assertStrictSemver, BETA_COUNTER_PATTERN, packedBetaVersion, parseBetaCounter } from './driver-semver.js';\n\nexport {\n  assertStrictSemver,\n  BETA_COUNTER_PATTERN,\n  BETA_VERSION_PATTERN,\n  compareDriverVersions,\n  compareToCatalogVersion,\n  packedBetaVersion,\n  parseBetaCounter,\n  STRICT_SEMVER_PATTERN,\n} from './driver-semver.js';\n\nexport const MAX_BETA_ZIP_BYTES = 1024 * 1024;\n\nexport interface RadioModuleConfigDescriptor {\n  fileName: string;\n  relativeConfig: string;\n  modelId: string;\n  name: string;\n  configVersion: string;\n  minApiVersion: string;\n  manufacturer: string;\n  parsed: unknown;\n}\n\nexport interface PackBetaOptions {\n  outputDirectory?: string;\n}\n\nexport interface PackBetaResult {\n  zipPath: string;\n  zipName: string;\n  modelId: string;\n  baseVersion: string;\n  packedVersion: string;\n  size: number;\n  sha256: string;\n  gitSha?: string;\n}\n\nexport function expectedBetaZipName(modelId: string, baseVersion: string, n: number): string {\n  return `radio-module-${modelId}-${baseVersion}-beta.${n}.zip`;\n}\n\nexport function packBetaZip(moduleRoot: string, modelId: string, n = 1, options: PackBetaOptions = {}): PackBetaResult {\n  if (!Number.isSafeInteger(n) || !BETA_COUNTER_PATTERN.test(String(n))) {\n    throw new Error('beta counter n must be a positive integer with no leading zero');\n  }\n\n  const descriptor = loadDescriptor(moduleRoot, modelId);\n  validateBetaDescriptor(descriptor);\n\n  const pathsToZip = closurePathsForConfig(moduleRoot, descriptor);\n  const version = packedBetaVersion(descriptor.configVersion, n);\n  const zipName = expectedBetaZipName(descriptor.modelId, descriptor.configVersion, n);\n  const outputDirectory = options.outputDirectory ?? join(moduleRoot, 'dist-release');\n  const zipPath = join(outputDirectory, zipName);\n\n  mkdirSync(outputDirectory, { recursive: true });\n\n  const stagingRoot = mkdtempSync(join(tmpdir(), 'pack-beta-'));\n\n  try {\n    stageClosureWithBetaVersion(moduleRoot, stagingRoot, pathsToZip, descriptor.relativeConfig, version);\n    createZipFromStaging(stagingRoot, zipPath, pathsToZip);\n  } finally {\n    rmSync(stagingRoot, { recursive: true, force: true });\n  }\n\n  const size = statSync(zipPath).size;\n\n  if (size > MAX_BETA_ZIP_BYTES) {\n    unlinkSync(zipPath);\n    throw new Error(`beta zip exceeds ${MAX_BETA_ZIP_BYTES} bytes (${size} bytes)`);\n  }\n\n  const sha256 = integrityFromFile(zipPath);\n  const gitSha = shortGitSha(moduleRoot);\n\n  return {\n    zipPath,\n    zipName,\n    modelId: descriptor.modelId,\n    baseVersion: descriptor.configVersion,\n    packedVersion: version,\n    size,\n    sha256,\n    ...(gitSha ? { gitSha } : {}),\n  };\n}\n\nexport function validateBetaDescriptor(descriptor: Pick<RadioModuleConfigDescriptor, 'relativeConfig' | 'configVersion' | 'minApiVersion'>): void {\n  const { relativeConfig, configVersion, minApiVersion } = descriptor;\n\n  if (typeof configVersion !== 'string' || configVersion.length === 0) {\n    throw new Error(`${relativeConfig} is missing version`);\n  }\n\n  if (configVersion.includes('-') || configVersion.includes('+')) {\n    throw new Error(`${relativeConfig} version must not include a prerelease or build metadata suffix`);\n  }\n\n  assertStrictSemver(configVersion, `${relativeConfig} version`);\n\n  if (typeof minApiVersion !== 'string' || minApiVersion.length === 0) {\n    throw new Error(`${relativeConfig} is missing minApiVersion`);\n  }\n\n  if (minApiVersion.includes('-') || minApiVersion.includes('+')) {\n    throw new Error(`${relativeConfig} minApiVersion must not include a prerelease or build metadata suffix`);\n  }\n\n  assertStrictSemver(minApiVersion, `${relativeConfig} minApiVersion`);\n}\n\nexport function listConfigDescriptors(moduleRoot: string): RadioModuleConfigDescriptor[] {\n  const configDirectory = join(moduleRoot, 'configs');\n\n  if (!existsSync(configDirectory)) {\n    throw new Error('configs directory is missing');\n  }\n\n  const manufacturerDefault = readManufacturerDefault(moduleRoot);\n\n  return readdirSync(configDirectory)\n    .filter((fileName) => fileName.endsWith('.json'))\n    .sort()\n    .map((fileName) => parseConfigDescriptor(moduleRoot, fileName, manufacturerDefault));\n}\n\nexport function parseConfigDescriptor(moduleRoot: string, fileName: string, manufacturerDefault?: string): RadioModuleConfigDescriptor {\n  const relativeConfig = `configs/${fileName}`;\n  const absoluteConfig = join(moduleRoot, relativeConfig);\n  let parsed: unknown;\n\n  try {\n    parsed = JSON.parse(readFileSync(absoluteConfig, 'utf8')) as unknown;\n  } catch {\n    throw new Error(`${relativeConfig} is not valid JSON`);\n  }\n\n  const record = parsed && typeof parsed === 'object' ? (parsed as Record<string, unknown>) : {};\n  const id = record.id && typeof record.id === 'object' ? (record.id as Record<string, unknown>) : {};\n  const modelId = id.model;\n  const name = id.name;\n  const configVersion = record.version;\n  const minApiVersion = record.minApiVersion;\n  const manufacturer = typeof id.manufacturer === 'string' && id.manufacturer.length > 0 ? id.manufacturer : manufacturerDefault;\n\n  if (typeof modelId !== 'string' || modelId.length === 0) {\n    throw new Error(`${relativeConfig} is missing id.model`);\n  }\n\n  if (typeof name !== 'string' || name.length === 0) {\n    throw new Error(`${relativeConfig} is missing id.name`);\n  }\n\n  if (typeof configVersion !== 'string' || configVersion.length === 0) {\n    throw new Error(`${relativeConfig} is missing version`);\n  }\n\n  if (typeof minApiVersion !== 'string' || minApiVersion.length === 0) {\n    throw new Error(`${relativeConfig} is missing minApiVersion`);\n  }\n\n  if (typeof manufacturer !== 'string' || manufacturer.length === 0) {\n    throw new Error(`${relativeConfig} is missing id.manufacturer`);\n  }\n\n  const expectedFile = `configs/${modelId}.json`;\n\n  if (relativeConfig !== expectedFile) {\n    throw new Error(`${relativeConfig} must be named ${expectedFile} (id.model ${modelId})`);\n  }\n\n  return {\n    fileName,\n    relativeConfig,\n    modelId,\n    name,\n    configVersion,\n    minApiVersion,\n    manufacturer,\n    parsed,\n  };\n}\n\nexport function closurePathsForConfig(moduleRoot: string, descriptor: Pick<RadioModuleConfigDescriptor, 'relativeConfig'>): string[] {\n  const paths = collectRefClosure(moduleRoot, descriptor.relativeConfig);\n\n  for (const relativePath of paths) {\n    if (!existsSync(join(moduleRoot, relativePath))) {\n      throw new Error(`${descriptor.relativeConfig} $ref target is missing: ${relativePath}`);\n    }\n  }\n\n  return paths;\n}\n\nexport function stageClosureWithBetaVersion(moduleRoot: string, stagingRoot: string, relativePaths: string[], configRelative: string, version: string): void {\n  for (const relativePath of relativePaths) {\n    const sourcePath = join(moduleRoot, relativePath);\n    const destPath = join(stagingRoot, relativePath);\n\n    mkdirSync(dirname(destPath), { recursive: true });\n\n    if (relativePath === configRelative) {\n      const parsed = JSON.parse(readFileSync(sourcePath, 'utf8')) as Record<string, unknown>;\n      parsed.version = version;\n      writeFileSync(destPath, `${JSON.stringify(parsed, null, 2)}\\n`);\n    } else {\n      cpSync(sourcePath, destPath);\n    }\n  }\n}\n\nexport function shortGitSha(moduleRoot: string): string | undefined {\n  const result = spawnSync('git', ['rev-parse', '--short', 'HEAD'], {\n    cwd: moduleRoot,\n    encoding: 'utf8',\n  });\n\n  if (result.status !== 0) {\n    return undefined;\n  }\n\n  const sha = result.stdout.trim();\n  return sha.length > 0 ? sha : undefined;\n}\n\nexport function formatBetaPackOutput(result: Pick<PackBetaResult, 'zipPath' | 'size' | 'sha256' | 'gitSha'>): string {\n  const lines = [result.zipPath, String(result.size), result.sha256];\n\n  if (result.gitSha) {\n    lines.push(result.gitSha);\n  }\n\n  return `${lines.join('\\n')}\\n`;\n}\n\nexport interface PackBetaCliIo {\n  write(chunk: string): void;\n}\n\nexport function runPackBetaCli(args: readonly string[], moduleRoot: string, stdout: PackBetaCliIo = process.stdout, stderr: PackBetaCliIo = process.stderr): number {\n  const [modelId, nArg, ...rest] = args;\n\n  if (!modelId || rest.length > 0) {\n    stderr.write('usage: yarn pack:beta <modelId> [n]\\n');\n    return 1;\n  }\n\n  try {\n    const n = parseBetaCounter(nArg);\n    const result = packBetaZip(moduleRoot, modelId, n);\n    stdout.write(formatBetaPackOutput(result));\n    return 0;\n  } catch (error) {\n    stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`);\n    return 1;\n  }\n}\n\nfunction loadDescriptor(moduleRoot: string, modelId: string): RadioModuleConfigDescriptor {\n  const descriptors = listConfigDescriptors(moduleRoot);\n  const descriptor = descriptors.find((entry) => entry.modelId === modelId);\n\n  if (!descriptor) {\n    const known = descriptors.map((entry) => entry.modelId).join(', ');\n    throw new Error(`unknown modelId ${modelId}; expected one of: ${known}`);\n  }\n\n  return descriptor;\n}\n\nfunction readManufacturerDefault(moduleRoot: string): string | undefined {\n  const packagePath = join(moduleRoot, 'package.json');\n\n  if (!existsSync(packagePath)) {\n    return undefined;\n  }\n\n  let parsed: unknown;\n\n  try {\n    parsed = JSON.parse(readFileSync(packagePath, 'utf8')) as unknown;\n  } catch {\n    throw new Error('package.json is not valid JSON');\n  }\n\n  if (!parsed || typeof parsed !== 'object') {\n    return undefined;\n  }\n\n  const springfield = (parsed as Record<string, unknown>).springfield;\n\n  if (!springfield || typeof springfield !== 'object') {\n    return undefined;\n  }\n\n  const manufacturer = (springfield as Record<string, unknown>).manufacturer;\n  return typeof manufacturer === 'string' && manufacturer.length > 0 ? manufacturer : undefined;\n}\n\nfunction createZipFromStaging(stagingRoot: string, zipPath: string, relativePaths: string[]): void {\n  if (existsSync(zipPath)) {\n    unlinkSync(zipPath);\n  }\n\n  const zipResult = spawnSync('zip', ['-q', zipPath, ...relativePaths, '-x', '*.DS_Store'], {\n    cwd: stagingRoot,\n    encoding: 'utf8',\n  });\n\n  if (zipResult.status !== 0) {\n    throw new Error(zipResult.stderr || zipResult.stdout || 'zip failed');\n  }\n}\n\nfunction integrityFromFile(filePath: string): string {\n  const hash = createHash('sha256').update(readFileSync(filePath)).digest('hex');\n  return `sha256:${hash}`;\n}\n"]}

package/dist/pack/ref-closure.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @returns Sorted repo-relative paths, including `startRelative`
+ */
+export declare function collectRefClosure(moduleRoot: string, startRelative: string): string[];
+export declare function readWorkingTreeText(moduleRoot: string, relativePath: string): string | undefined;
+export declare function localRefTargets(value: unknown, into?: string[]): string[];
+/**
+ * Path portion of a relative file `$ref`, without a JSON pointer.
+ * Fragment-only refs and absolute URIs are ignored.
+ */
+export declare function filePathFromRef(ref: string): string | undefined;
+//# sourceMappingURL=ref-closure.d.ts.map

package/dist/pack/ref-closure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-closure.d.ts","sourceRoot":"","sources":["../../src/pack/ref-closure.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CA2CrF;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQhG;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE,CA4B7E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAS/D"}