@bcts/seedtool-cli 1.0.0-alpha.22 → 1.0.0-beta.0

package/dist/index.mjs

@@ -1,4 +1,5 @@
 import * as readline from "node:readline";
+import * as fs from "node:fs";
 import { SSKRGroupSpec, SSKRSecret, SSKRShare, SSKRSpec, Seed as Seed$1, sskrCombine, sskrGenerate } from "@bcts/components";
 import { Envelope, SymmetricKey } from "@bcts/envelope";
 import { DATE, NAME, NOTE, SEED_TYPE } from "@bcts/known-values";
@@ -9,7 +10,6 @@ import { entropyToMnemonic, mnemonicToEntropy, validateMnemonic } from "@scure/b
 import { wordlist } from "@scure/bip39/wordlists/english.js";
 import { BytewordsStyle, MultipartDecoder, MultipartEncoder, UR, decodeBytewords, encodeBytewords } from "@bcts/uniform-resources";
 import { SSKR_SHARE, SSKR_SHARE_V1 } from "@bcts/tags";
-
 //#region src/cli.ts
 /**
 * Copyright © 2023-2026 Blockchain Commons, LLC
@@ -135,9 +135,9 @@ var Cli = class Cli {
 	/** The number of output units (hex bytes, base-10 digits, etc.) */
 	count = 16;
 	/** The input format. Default: Random */
-	in = InputFormatKey.Random;
+	in = "random";
 	/** The output format. Default: Hex */
-	out = OutputFormatKey.Hex;
+	out = "hex";
 	/** The lowest int returned (0-254). Default: 0 */
 	low = 0;
 	/** The highest int returned (1-255), low < high. Default: 9 */
@@ -157,7 +157,7 @@ var Cli = class Cli {
 	/** The number of groups that must meet their threshold. Default: 1 */
 	groupThreshold = 1;
 	/** SSKR output format. Default: Envelope */
-	sskrFormat = SSKRFormatKey.Envelope;
+	sskrFormat = "envelope";
 	/** Deterministic RNG seed string. */
 	deterministic;
 	/** The seed being processed (internal state). */
@@ -165,12 +165,21 @@ var Cli = class Cli {
 	/** The RNG source (internal state). */
 	rng;
 	/**
-	* Get input from argument or read from stdin.
-	* Matches Rust expect_input method.
+	* Get input from argument or lazily read it from stdin.
+	*
+	* Mirrors Rust's `Cli::expect_input` (seedtool-cli-rust/src/cli.rs:191-200):
+	* stdin is touched only when an input-consuming code path actually needs it.
+	* Modes like `--in random` or `-d <SEED>` (deterministic) never call this,
+	* so they exit cleanly even when stdin is a non-TTY but no input is piped.
+	*
+	* Reads the stdin file descriptor synchronously via `fs.readFileSync(0, ...)`
+	* and caches the trimmed result on `this.input` so subsequent calls don't
+	* re-read.
 	*/
 	expectInput() {
 		if (this.input !== void 0) return this.input;
-		throw new Error("Input required but not provided. Use stdin or pass as argument.");
+		this.input = fs.readFileSync(0, "utf-8").trim();
+		return this.input;
 	}
 	/**
 	* Get input from argument or read from stdin asynchronously.
@@ -263,7 +272,6 @@ var Cli = class Cli {
 		return cli;
 	}
 };
-
 //#endregion
 //#region src/seed.ts
 /**
@@ -471,7 +479,6 @@ var Seed = class Seed {
 		return true;
 	}
 };
-
 //#endregion
 //#region src/random.ts
 /**
@@ -579,7 +586,6 @@ function sha256DeterministicRandomString(str, n) {
 function deterministicRandom(entropy, n) {
 	return hkdfHmacSha256(sha256(entropy), new Uint8Array(0), n);
 }
-
 //#endregion
 //#region src/util.ts
 /**
@@ -599,18 +605,34 @@ function dataToHex(bytes) {
 }
 /**
 * Convert hex string to bytes.
-* Matches Rust hex_to_data function.
+*
+* Mirrors the error wording produced by Rust's `hex` crate
+* (`FromHexError::OddLength` and `FromHexError::InvalidHexCharacter`),
+* which seedtool-cli-rust surfaces unchanged through anyhow:
+*
+*   "Odd number of digits"
+*   "Invalid character '{c}' at position {n}"
+*
+* The outer CLI layer adds the `Error: ` prefix to match Rust's anyhow
+* output.
 */
 function hexToData(hex) {
-	if (hex.length % 2 !== 0) throw new Error("Hex string must have even length");
+	if (hex.length % 2 !== 0) throw new Error("Odd number of digits");
 	const bytes = new Uint8Array(hex.length / 2);
 	for (let i = 0; i < hex.length; i += 2) {
-		const byte = parseInt(hex.substring(i, i + 2), 16);
-		if (isNaN(byte)) throw new Error(`Invalid hex character at position ${i}`);
-		bytes[i / 2] = byte;
+		const hi = hexCharToNibble(hex, i);
+		const lo = hexCharToNibble(hex, i + 1);
+		bytes[i / 2] = hi << 4 | lo;
 	}
 	return bytes;
 }
+function hexCharToNibble(hex, index) {
+	const c = hex.charCodeAt(index);
+	if (c >= 48 && c <= 57) return c - 48;
+	if (c >= 97 && c <= 102) return c - 97 + 10;
+	if (c >= 65 && c <= 70) return c - 65 + 10;
+	throw new Error(`Invalid character '${hex[index]}' at position ${index}`);
+}
 /**
 * Convert byte values to a different base range [0, base-1].
 * Each byte (0-255) is scaled proportionally to the target base.
@@ -688,12 +710,11 @@ function digitsToData(inStr, low, high) {
 	const result = [];
 	for (const c of inStr) {
 		const n = c.charCodeAt(0) - "0".charCodeAt(0);
-		if (n < low || n > high) throw new Error(`Invalid digit: ${c}. Expected range [${low}-${high}].`);
+		if (n < low || n > high) throw new Error("Invalid digit.");
 		result.push(n);
 	}
 	return new Uint8Array(result);
 }
-
 //#endregion
 //#region src/formats/hex.ts
 /**
@@ -716,7 +737,6 @@ var HexFormat = class {
 		return dataToHex(state.expectSeed().data());
 	}
 };
-
 //#endregion
 //#region src/formats/bip39.ts
 /**
@@ -741,18 +761,9 @@ var Bip39Format = class {
 		return entropyToMnemonic(state.expectSeed().data(), wordlist);
 	}
 };
-
 //#endregion
 //#region src/formats/sskr.ts
 /**
-* Copyright © 2023-2026 Blockchain Commons, LLC
-* Copyright © 2025-2026 Parity Technologies
-*
-*
-* SSKR format
-* Ported from seedtool-cli-rust/src/formats/sskr.rs
-*/
-/**
 * SSKR format handler.
 * Round-trippable: sskr shares → seed → sskr shares.
 * Supports multiple sub-formats: envelope, btw, btwm, btwu, ur.
@@ -777,15 +788,15 @@ var SSKRFormat = class {
 };
 function outputSskrSeed(seed, spec, format) {
 	switch (format) {
-		case SSKRFormatKey.Envelope: {
+		case "envelope": {
 			const seedEnvelope = seed.toEnvelope();
 			const contentKey = SymmetricKey.new();
 			return seedEnvelope.wrap().encryptSubject(contentKey).sskrSplitFlattened(spec, contentKey).map((env) => env.urString()).join("\n");
 		}
-		case SSKRFormatKey.Btw: return makeBytewordsShares(spec, seed, BytewordsStyle.Standard);
-		case SSKRFormatKey.Btwm: return makeBytewordsShares(spec, seed, BytewordsStyle.Minimal);
-		case SSKRFormatKey.Btwu: return makeBytewordsShares(spec, seed, BytewordsStyle.Uri);
-		case SSKRFormatKey.Ur: return makeShares(spec, seed).map((share) => {
+		case "btw": return makeBytewordsShares(spec, seed, BytewordsStyle.Standard);
+		case "btwm": return makeBytewordsShares(spec, seed, BytewordsStyle.Minimal);
+		case "btwu": return makeBytewordsShares(spec, seed, BytewordsStyle.Uri);
+		case "ur": return makeShares(spec, seed).map((share) => {
 			return UR.new("sskr", toByteString(share.asBytes())).toString();
 		}).join("\n");
 	}
@@ -895,7 +906,6 @@ function parseSskrSeed(input) {
 	if (urLegacyResult !== null) return urLegacyResult;
 	throw new Error("Insufficient or invalid SSKR shares.");
 }
-
 //#endregion
 //#region src/formats/envelope.ts
 /**
@@ -919,7 +929,6 @@ var EnvelopeFormat = class {
 		return state.toEnvelope().urString();
 	}
 };
-
 //#endregion
 //#region src/formats/seed-format.ts
 /**
@@ -944,7 +953,6 @@ var SeedFormat = class {
 		return state.seedWithOverrides().toComponentsSeed().urString();
 	}
 };
-
 //#endregion
 //#region src/formats/multipart.ts
 /**
@@ -966,7 +974,7 @@ var MultipartFormat = class {
 			decoder.receive(share);
 			if (decoder.isComplete()) break;
 		}
-		if (!decoder.isComplete()) throw new Error("Insufficient multipart shares");
+		if (!decoder.isComplete()) throw new Error("Insufficient SSKR shares");
 		const ur = decoder.message();
 		if (ur === void 0 || ur === null) throw new Error("Failed to decode multipart message");
 		const envelope = Envelope.fromUR(ur);
@@ -981,7 +989,6 @@ var MultipartFormat = class {
 		return parts.join("\n");
 	}
 };
-
 //#endregion
 //#region src/formats/random.ts
 /**
@@ -1001,7 +1008,6 @@ var RandomFormat = class {
 		return state;
 	}
 };
-
 //#endregion
 //#region src/formats/base6.ts
 /**
@@ -1027,7 +1033,6 @@ var Base6Format = class {
 		return dataToInts(state.expectSeed().data(), 0, 5, "");
 	}
 };
-
 //#endregion
 //#region src/formats/base10.ts
 /**
@@ -1053,7 +1058,6 @@ var Base10Format = class {
 		return dataToInts(state.expectSeed().data(), 0, 9, "");
 	}
 };
-
 //#endregion
 //#region src/formats/bits.ts
 /**
@@ -1079,7 +1083,6 @@ var BitsFormat = class {
 		return dataToInts(state.expectSeed().data(), 0, 1, "");
 	}
 };
-
 //#endregion
 //#region src/formats/dice.ts
 /**
@@ -1105,7 +1108,6 @@ var DiceFormat = class {
 		return dataToInts(state.expectSeed().data(), 1, 6, "");
 	}
 };
-
 //#endregion
 //#region src/formats/cards.ts
 const CARD_SUITS = "cdhs";
@@ -1117,7 +1119,7 @@ const CARD_RANKS = "a23456789tjqk";
 function parseRank(c) {
 	const lower = c.toLowerCase();
 	const index = CARD_RANKS.indexOf(lower);
-	if (index === -1) throw new Error(`Invalid card rank: ${c}. Allowed: [A,2-9,T,J,Q,K]`);
+	if (index === -1) throw new Error("Invalid card rank. Allowed: [A,2-9,T,J,Q,K]");
 	return index;
 }
 /**
@@ -1127,7 +1129,7 @@ function parseRank(c) {
 function parseSuit(c) {
 	const lower = c.toLowerCase();
 	const index = CARD_SUITS.indexOf(lower);
-	if (index === -1) throw new Error(`Invalid card suit: ${c}. Allowed: [C,D,H,S]`);
+	if (index === -1) throw new Error("Invalid card rank. Allowed: [D,C,H,S]");
 	return index;
 }
 /**
@@ -1175,7 +1177,6 @@ var CardsFormat = class {
 		return dataToAlphabet(state.expectSeed().data(), 52, toCard);
 	}
 };
-
 //#endregion
 //#region src/formats/ints.ts
 /**
@@ -1199,7 +1200,6 @@ var IntsFormat = class {
 		return dataToInts(state.expectSeed().data(), state.low, state.high, " ");
 	}
 };
-
 //#endregion
 //#region src/formats/bytewords-standard.ts
 /**
@@ -1223,7 +1223,6 @@ var BytewordsStandardFormat = class {
 		return encodeBytewords(state.expectSeed().data(), BytewordsStyle.Standard);
 	}
 };
-
 //#endregion
 //#region src/formats/bytewords-minimal.ts
 /**
@@ -1247,7 +1246,6 @@ var BytewordsMinimalFormat = class {
 		return encodeBytewords(state.expectSeed().data(), BytewordsStyle.Minimal);
 	}
 };
-
 //#endregion
 //#region src/formats/bytewords-uri.ts
 /**
@@ -1271,39 +1269,30 @@ var BytewordsUriFormat = class {
 		return encodeBytewords(state.expectSeed().data(), BytewordsStyle.Uri);
 	}
 };
-
 //#endregion
 //#region src/formats/format.ts
 /**
-* Copyright © 2023-2026 Blockchain Commons, LLC
-* Copyright © 2025-2026 Parity Technologies
-*
-*
-* Format traits and factory functions
-* Ported from seedtool-cli-rust/src/formats/format.rs
-*/
-/**
 * Select input format by key.
 * Matches Rust select_input_format function.
 */
 function selectInputFormat(key) {
 	switch (key) {
-		case InputFormatKey.Random: return new RandomFormat();
-		case InputFormatKey.Hex: return new HexFormat();
-		case InputFormatKey.Btw: return new BytewordsStandardFormat();
-		case InputFormatKey.Btwu: return new BytewordsUriFormat();
-		case InputFormatKey.Btwm: return new BytewordsMinimalFormat();
-		case InputFormatKey.Bits: return new BitsFormat();
-		case InputFormatKey.Cards: return new CardsFormat();
-		case InputFormatKey.Dice: return new DiceFormat();
-		case InputFormatKey.Base6: return new Base6Format();
-		case InputFormatKey.Base10: return new Base10Format();
-		case InputFormatKey.Ints: return new IntsFormat();
-		case InputFormatKey.Bip39: return new Bip39Format();
-		case InputFormatKey.Sskr: return new SSKRFormat();
-		case InputFormatKey.Envelope: return new EnvelopeFormat();
-		case InputFormatKey.Multipart: return new MultipartFormat();
-		case InputFormatKey.Seed: return new SeedFormat();
+		case "random": return new RandomFormat();
+		case "hex": return new HexFormat();
+		case "btw": return new BytewordsStandardFormat();
+		case "btwu": return new BytewordsUriFormat();
+		case "btwm": return new BytewordsMinimalFormat();
+		case "bits": return new BitsFormat();
+		case "cards": return new CardsFormat();
+		case "dice": return new DiceFormat();
+		case "base6": return new Base6Format();
+		case "base10": return new Base10Format();
+		case "ints": return new IntsFormat();
+		case "bip39": return new Bip39Format();
+		case "sskr": return new SSKRFormat();
+		case "envelope": return new EnvelopeFormat();
+		case "multipart": return new MultipartFormat();
+		case "seed": return new SeedFormat();
 	}
 }
 /**
@@ -1312,24 +1301,24 @@ function selectInputFormat(key) {
 */
 function selectOutputFormat(key) {
 	switch (key) {
-		case OutputFormatKey.Hex: return new HexFormat();
-		case OutputFormatKey.Btw: return new BytewordsStandardFormat();
-		case OutputFormatKey.Btwu: return new BytewordsUriFormat();
-		case OutputFormatKey.Btwm: return new BytewordsMinimalFormat();
-		case OutputFormatKey.Bits: return new BitsFormat();
-		case OutputFormatKey.Cards: return new CardsFormat();
-		case OutputFormatKey.Dice: return new DiceFormat();
-		case OutputFormatKey.Base6: return new Base6Format();
-		case OutputFormatKey.Base10: return new Base10Format();
-		case OutputFormatKey.Ints: return new IntsFormat();
-		case OutputFormatKey.Bip39: return new Bip39Format();
-		case OutputFormatKey.Sskr: return new SSKRFormat();
-		case OutputFormatKey.Envelope: return new EnvelopeFormat();
-		case OutputFormatKey.Multipart: return new MultipartFormat();
-		case OutputFormatKey.Seed: return new SeedFormat();
+		case "hex": return new HexFormat();
+		case "btw": return new BytewordsStandardFormat();
+		case "btwu": return new BytewordsUriFormat();
+		case "btwm": return new BytewordsMinimalFormat();
+		case "bits": return new BitsFormat();
+		case "cards": return new CardsFormat();
+		case "dice": return new DiceFormat();
+		case "base6": return new Base6Format();
+		case "base10": return new Base10Format();
+		case "ints": return new IntsFormat();
+		case "bip39": return new Bip39Format();
+		case "sskr": return new SSKRFormat();
+		case "envelope": return new EnvelopeFormat();
+		case "multipart": return new MultipartFormat();
+		case "seed": return new SeedFormat();
 	}
 }
-
 //#endregion
 export { Base10Format, Base6Format, Bip39Format, BitsFormat, BytewordsMinimalFormat, BytewordsStandardFormat, BytewordsUriFormat, CardsFormat, Cli, DeterministicRandomNumberGenerator, DiceFormat, EnvelopeFormat, HexFormat, InputFormatKey, IntsFormat, MultipartFormat, OutputFormatKey, RandomFormat, SSKRFormat, SSKRFormatKey, Seed, SeedFormat, dataToAlphabet, dataToBase, dataToHex, dataToInts, deterministicRandom, digitsToData, hexToData, hkdfHmacSha256, parseDate, parseGroupSpec, parseGroupThreshold, parseHighInt, parseInts, parseLowInt, selectInputFormat, selectOutputFormat, sha256DeterministicRandom };
+
 //# sourceMappingURL=index.mjs.map