@springfield/ham-radio-utils 4.16.0 → 4.17.0

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"}

package/dist/pack/ref-closure.js

@@ -0,0 +1,93 @@
+/**
+ * Transitive relative `$ref` closure for one radio config.
+ * Matches the file set `pack:release` zips for that model: shared schemas and
+ * memory maps the config reaches, and not sibling radios.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join, relative, resolve, sep } from 'node:path';
+/**
+ * @returns Sorted repo-relative paths, including `startRelative`
+ */
+export function collectRefClosure(moduleRoot, startRelative) {
+    const included = new Set([startRelative]);
+    const pending = [startRelative];
+    while (pending.length > 0) {
+        const current = pending.pop();
+        if (!current) {
+            continue;
+        }
+        const text = readWorkingTreeText(moduleRoot, current);
+        if (text === undefined) {
+            continue;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            continue;
+        }
+        const fromDirectory = dirname(join(moduleRoot, current));
+        for (const refPath of localRefTargets(parsed)) {
+            const absolutePath = resolve(fromDirectory, refPath);
+            const relativePath = toRepoRelative(moduleRoot, absolutePath);
+            if (relativePath === undefined) {
+                throw new Error(`${current} $ref escapes the repository: ${refPath}`);
+            }
+            if (!included.has(relativePath)) {
+                included.add(relativePath);
+                pending.push(relativePath);
+            }
+        }
+    }
+    return [...included].sort();
+}
+export function readWorkingTreeText(moduleRoot, relativePath) {
+    const absolutePath = join(moduleRoot, relativePath);
+    if (!existsSync(absolutePath)) {
+        return undefined;
+    }
+    return readFileSync(absolutePath, 'utf8');
+}
+export function localRefTargets(value, into = []) {
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            localRefTargets(item, into);
+        }
+        return into;
+    }
+    if (!value || typeof value !== 'object') {
+        return into;
+    }
+    const record = value;
+    if (typeof record.$ref === 'string') {
+        const refPath = filePathFromRef(record.$ref);
+        if (refPath) {
+            into.push(refPath);
+        }
+    }
+    for (const child of Object.values(record)) {
+        localRefTargets(child, into);
+    }
+    return into;
+}
+/**
+ * Path portion of a relative file `$ref`, without a JSON pointer.
+ * Fragment-only refs and absolute URIs are ignored.
+ */
+export function filePathFromRef(ref) {
+    if (ref.length === 0 || ref.startsWith('#') || /^[a-z][a-z0-9+.-]*:/i.test(ref)) {
+        return undefined;
+    }
+    const hashIndex = ref.indexOf('#');
+    const refPath = hashIndex === -1 ? ref : ref.slice(0, hashIndex);
+    return refPath.length > 0 ? refPath : undefined;
+}
+function toRepoRelative(rootDirectory, absolutePath) {
+    const relativePath = relative(rootDirectory, absolutePath);
+    if (relativePath === '' || relativePath.startsWith('..') || relativePath.includes(`${sep}..`)) {
+        return undefined;
+    }
+    return relativePath.split(sep).join('/');
+}
+//# sourceMappingURL=ref-closure.js.map

package/dist/pack/ref-closure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-closure.js","sourceRoot":"","sources":["../../src/pack/ref-closure.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Transitive relative `$ref` closure for one radio config.\n * Matches the file set `pack:release` zips for that model: shared schemas and\n * memory maps the config reaches, and not sibling radios.\n */\nimport { existsSync, readFileSync } from 'node:fs';\nimport { dirname, join, relative, resolve, sep } from 'node:path';\n\n/**\n * @returns Sorted repo-relative paths, including `startRelative`\n */\nexport function collectRefClosure(moduleRoot: string, startRelative: string): string[] {\n  const included = new Set<string>([startRelative]);\n  const pending = [startRelative];\n\n  while (pending.length > 0) {\n    const current = pending.pop();\n\n    if (!current) {\n      continue;\n    }\n\n    const text = readWorkingTreeText(moduleRoot, current);\n\n    if (text === undefined) {\n      continue;\n    }\n\n    let parsed: unknown;\n\n    try {\n      parsed = JSON.parse(text) as unknown;\n    } catch {\n      continue;\n    }\n\n    const fromDirectory = dirname(join(moduleRoot, current));\n\n    for (const refPath of localRefTargets(parsed)) {\n      const absolutePath = resolve(fromDirectory, refPath);\n      const relativePath = toRepoRelative(moduleRoot, absolutePath);\n\n      if (relativePath === undefined) {\n        throw new Error(`${current} $ref escapes the repository: ${refPath}`);\n      }\n\n      if (!included.has(relativePath)) {\n        included.add(relativePath);\n        pending.push(relativePath);\n      }\n    }\n  }\n\n  return [...included].sort();\n}\n\nexport function readWorkingTreeText(moduleRoot: string, relativePath: string): string | undefined {\n  const absolutePath = join(moduleRoot, relativePath);\n\n  if (!existsSync(absolutePath)) {\n    return undefined;\n  }\n\n  return readFileSync(absolutePath, 'utf8');\n}\n\nexport function localRefTargets(value: unknown, into: string[] = []): string[] {\n  if (Array.isArray(value)) {\n    for (const item of value) {\n      localRefTargets(item, into);\n    }\n\n    return into;\n  }\n\n  if (!value || typeof value !== 'object') {\n    return into;\n  }\n\n  const record = value as Record<string, unknown>;\n\n  if (typeof record.$ref === 'string') {\n    const refPath = filePathFromRef(record.$ref);\n\n    if (refPath) {\n      into.push(refPath);\n    }\n  }\n\n  for (const child of Object.values(record)) {\n    localRefTargets(child, into);\n  }\n\n  return into;\n}\n\n/**\n * Path portion of a relative file `$ref`, without a JSON pointer.\n * Fragment-only refs and absolute URIs are ignored.\n */\nexport function filePathFromRef(ref: string): string | undefined {\n  if (ref.length === 0 || ref.startsWith('#') || /^[a-z][a-z0-9+.-]*:/i.test(ref)) {\n    return undefined;\n  }\n\n  const hashIndex = ref.indexOf('#');\n  const refPath = hashIndex === -1 ? ref : ref.slice(0, hashIndex);\n\n  return refPath.length > 0 ? refPath : undefined;\n}\n\nfunction toRepoRelative(rootDirectory: string, absolutePath: string): string | undefined {\n  const relativePath = relative(rootDirectory, absolutePath);\n\n  if (relativePath === '' || relativePath.startsWith('..') || relativePath.includes(`${sep}..`)) {\n    return undefined;\n  }\n\n  return relativePath.split(sep).join('/');\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@springfield/ham-radio-utils",
-  "version": "4.16.0",
+  "version": "4.17.0",
   "author": "Bryan Hunt",
   "license": "MIT",
   "readme": "README.md",
@@ -11,6 +11,9 @@
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "bin": {
+    "ham-radio-pack-beta": "./dist/pack/pack-beta-cli.js"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/springfield-ham-radio/ham-radio-utils.git"
@@ -25,6 +28,7 @@
     "lint": "oxlint",
     "lint:fix": "oxlint --fix --fix-suggestions",
     "release": "semantic-release",
+    "pack:beta": "ham-radio-pack-beta",
     "prepare": "husky && yarn build",
     "test": "yarn test:unit",
     "test:unit": "vitest run test/unit"

package/src/index.ts

@@ -17,6 +17,29 @@ 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 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/src/memory/memory-map-codec.ts

@@ -124,6 +124,53 @@ export function structInstanceAddress(struct: RadioMemoryMapStruct, instanceInde
   return seek + groupIndex * (stride * groupSize + groupPad) + indexInGroup * stride;
 }
 
+/**
+ * ASCII fields stop at NUL or 0xFF, then drop trailing spaces. The bytes after
+ * the visible text are not part of the setting value.
+ */
+function decodeAscii(bytes: readonly number[]): string {
+  let text = '';
+
+  for (const byte of bytes) {
+    if (byte === 0xff || byte === 0x00) {
+      break;
+    }
+
+    text += String.fromCodePoint(byte);
+  }
+
+  return text.trimEnd();
+}
+
+/**
+ * Clone images mix space, NUL, and 0xFF padding in one ASCII field. Re-encoding
+ * an unchanged value with the single declared pad rewrites those bytes (a
+ * TH-D74 power-on message ending in spaces came back NUL-padded; a D-STAR memo
+ * ending in NUL came back space-padded). When the text still matches what
+ * decode would return, keep the stored bytes. Edited text uses `kind.pad`.
+ */
+function encodeAscii(
+  kind: Extract<RadioMemoryMapValueKind, { kind: 'ascii' }>,
+  value: RadioSettingValue,
+  byteLength: number,
+  originalBytes: readonly number[] | undefined,
+): number[] {
+  const text = typeof value === 'string' ? value : '';
+
+  if (originalBytes && originalBytes.length === byteLength && decodeAscii(originalBytes) === text) {
+    return [...originalBytes];
+  }
+
+  const pad = kind.pad ?? 0xff;
+  const bytes: number[] = [];
+
+  for (let index = 0; index < byteLength; index += 1) {
+    bytes[index] = index < text.length ? (text.codePointAt(index) ?? pad) : pad;
+  }
+
+  return bytes;
+}
+
 function decodeRawValue(kind: RadioMemoryMapValueKind | undefined, raw: number | number[]): RadioSettingValue {
   if (!kind) {
     return typeof raw === 'number' ? raw : raw;
@@ -140,17 +187,7 @@ function decodeRawValue(kind: RadioMemoryMapValueKind | undefined, raw: number |
     }
     case 'ascii': {
       const bytes = typeof raw === 'number' ? [raw] : raw;
-      let text = '';
-
-      for (const byte of bytes) {
-        if (byte === 0xff || byte === 0x00) {
-          break;
-        }
-
-        text += String.fromCodePoint(byte);
-      }
-
-      return text.trimEnd();
+      return decodeAscii(bytes);
     }
     case 'digits': {
       const bytes = typeof raw === 'number' ? [raw] : raw;
@@ -246,7 +283,12 @@ function decodeRawValue(kind: RadioMemoryMapValueKind | undefined, raw: number |
   }
 }
 
-function encodeRawValue(kind: RadioMemoryMapValueKind | undefined, value: RadioSettingValue, byteLength: number): number[] {
+function encodeRawValue(
+  kind: RadioMemoryMapValueKind | undefined,
+  value: RadioSettingValue,
+  byteLength: number,
+  originalBytes?: readonly number[],
+): number[] {
   const bytes = Array.from({ length: byteLength }, () => 0xff);
 
   if (!kind) {
@@ -270,16 +312,8 @@ function encodeRawValue(kind: RadioMemoryMapValueKind | undefined, value: RadioS
       bytes[0] = index >= 0 ? index : 0;
       return bytes;
     }
-    case 'ascii': {
-      const text = typeof value === 'string' ? value : '';
-      const pad = kind.pad ?? 0xff;
-
-      for (let index = 0; index < byteLength; index += 1) {
-        bytes[index] = index < text.length ? (text.codePointAt(index) ?? pad) : pad;
-      }
-
-      return bytes;
-    }
+    case 'ascii':
+      return encodeAscii(kind, value, byteLength, originalBytes);
     case 'digits': {
       const scale = kind.scale ?? 1;
       let numeric = typeof value === 'number' ? Math.round(value / scale) : 0;
@@ -596,15 +630,27 @@ function encodeStruct(
     }
 
     const settingValue = values[field.id];
+    const originalBytes: number[] | undefined = field.value?.kind === 'ascii' ? [] : undefined;
+
+    if (originalBytes) {
+      for (let index = 0; index < length; index += 1) {
+        originalBytes.push(readByte(contents, bufferOffsetFor(radioAddress + index, memoryConfig, contents)));
+      }
+    }
 
     if (field.type === 'u16' || field.type === 'u32') {
-      const encoded = encodeRawValue(field.value ?? { kind: 'integer' }, settingValue ?? 0, length);
+      const encoded = encodeRawValue(field.value ?? { kind: 'integer' }, settingValue ?? 0, length, originalBytes);
 
       for (let index = 0; index < length; index += 1) {
         writeByte(contents, bufferOffsetFor(radioAddress + index, memoryConfig, contents), encoded[index] ?? 0);
       }
     } else {
-      const encoded = encodeRawValue(field.value, settingValue ?? (field.value?.kind === 'ascii' ? '' : 0), length);
+      const encoded = encodeRawValue(
+        field.value,
+        settingValue ?? (field.value?.kind === 'ascii' ? '' : 0),
+        length,
+        originalBytes,
+      );
 
       for (let index = 0; index < length; index += 1) {
         writeByte(contents, bufferOffsetFor(radioAddress + index, memoryConfig, contents), encoded[index]);