@bcts/dcbor-cli 1.0.0-alpha.13

package/LICENSE

@@ -0,0 +1,48 @@
+Copyright © 2023 Blockchain Commons, LLC
+Copyright © 2025 Leonardo Amoroso Custodio
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+    1. Redistributions of source code must retain the above copyright notice,
+    this list of conditions and the following disclaimer.
+
+    2. Redistributions in binary form must reproduce the above copyright notice,
+    this list of conditions and the following disclaimer in the documentation
+    and/or other materials provided with the distribution.
+
+Subject to the terms and conditions of this license, each copyright holder and
+contributor hereby grants to those receiving rights under this license a
+perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+(except for failure to satisfy the conditions of this license) patent license to
+make, have made, use, offer to sell, sell, import, and otherwise transfer this
+software, where such license applies only to those patent claims, already
+acquired or hereafter acquired, licensable by such copyright holder or
+contributor that are necessarily infringed by:
+
+    (a) their Contribution(s) (the licensed copyrights of copyright holders and
+    non-copyrightable additions of contributors, in source or binary form)
+    alone; or
+
+    (b) combination of their Contribution(s) with the work of authorship to
+    which such Contribution(s) was added by such copyright holder or
+    contributor, if, at the time the Contribution is added, such addition causes
+    such combination to be necessarily infringed. The patent license shall not
+    apply to any other combinations which include the Contribution.
+
+Except as expressly stated above, no rights or licenses from any copyright
+holder or contributor is granted under this license, whether expressly, by
+implication, estoppel or otherwise.
+
+DISCLAIMER
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
+TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,105 @@
+# Blockchain Commons dCBOR CLI (TypeScript)
+
+> Disclaimer: This package is under active development and APIs may change.
+
+## Introduction
+
+`@bcts/dcbor-cli` is a command line tool for parsing, validating, and converting [dCBOR](https://datatracker.ietf.org/doc/draft-mcnally-deterministic-cbor/) (Deterministic CBOR) data.
+
+Features:
+- Validates dCBOR inputs
+- Receives inputs in hex, binary, or diagnostic notation format
+- Outputs in multiple formats: diagnostic notation (compact or annotated), hexadecimal (compact or annotated), or binary
+- Compose dCBOR arrays and maps from individual elements
+
+## Rust Reference Implementation
+
+This TypeScript implementation is based on [bc-dcbor-cli](https://github.com/BlockchainCommons/bc-dcbor-cli) **v0.16.0** ([commit](https://github.com/BlockchainCommons/bc-dcbor-cli/tree/1977ba6e2934f58d49b0dbf10d171988d9cb31d3)).
+
+## Installation
+
+```bash
+# Install globally
+bun add -g @bcts/dcbor-cli
+
+# Or run directly with bunx
+bunx @bcts/dcbor-cli --help
+```
+
+## Usage
+
+### Basic Conversion
+
+Convert CBOR diagnostic notation to hexadecimal (default):
+
+```bash
+dcbor '42'
+# Output: 182a
+
+dcbor '3.14'
+# Output: fb40091eb851eb851f
+
+dcbor '"Hello"'
+# Output: 6548656c6c6f
+```
+
+### Input/Output Formats
+
+```bash
+# Convert hex to diagnostic notation
+dcbor --in hex --out diag 6548656c6c6f
+# Output: "Hello"
+
+# Convert with annotations
+dcbor --in hex --out diag --annotate 6548656c6c6f
+# Output: "Hello"   / text(5) /
+
+# Convert to binary
+dcbor --in hex --out bin 6548656c6c6f > output.bin
+
+# Read binary input
+dcbor --in bin < input.bin
+```
+
+### Compose Arrays and Maps
+
+```bash
+# Compose an array
+dcbor array 1 2 3
+# Output: hex for [1, 2, 3]
+
+# Compose a map
+dcbor map '"key1"' 1 '"key2"' 2
+# Output: hex for {"key1": 1, "key2": 2}
+```
+
+## Command Line Reference
+
+```
+Usage: dcbor [options] [input] [command]
+
+Commands:
+  array   Compose a dCBOR array from the provided elements
+  map     Compose a dCBOR map from the provided keys and values
+
+Arguments:
+  input   Input dCBOR (format specified by --in)
+
+Options:
+  -i, --in <format>    Input format: diag, hex, bin (default: diag)
+  -o, --out <format>   Output format: diag, hex, bin, none (default: hex)
+  -a, --annotate       Add annotations to output
+  -h, --help           Display help
+  -V, --version        Display version
+```
+
+## Dependencies
+
+- `@bcts/dcbor` - dCBOR encoding/decoding
+- `@bcts/dcbor-parse` - Diagnostic notation parser
+- `@bcts/dcbor-pattern` - Pattern matching
+- `@bcts/components` - Shared components
+
+## License
+
+BSD-2-Clause-Patent

package/dist/cli.cjs

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+const require_src = require('./src-M5HM-SCU.cjs');
+let commander = require("commander");
+
+//#region src/cli.ts
+/**
+* dcbor CLI - Command line parser/validator for deterministic CBOR (dCBOR)
+*
+* A command line tool for composing, parsing and validating Gordian dCBOR.
+* See the main repo README: https://github.com/leonardocustodio/bcts
+*/
+const program = new commander.Command();
+program.name("dcbor").description("Command line parser/validator for deterministic CBOR (dCBOR)").version(require_src.VERSION);
+program.argument("[input]", "Input dCBOR in the format specified by --in").addOption(new commander.Option("-i, --in <format>", "The input format").choices([
+	"diag",
+	"hex",
+	"bin"
+]).default("diag")).addOption(new commander.Option("-o, --out <format>", "The output format").choices([
+	"diag",
+	"hex",
+	"bin",
+	"none"
+]).default("hex")).option("-a, --annotate", "Output diagnostic notation or hexadecimal with annotations").action(async (input, options) => {
+	let stdinContent;
+	if (input === void 0 && options.in !== "bin") stdinContent = await readStdin();
+	else if (options.in === "bin") stdinContent = await readStdin();
+	const result = require_src.run({
+		command: {
+			type: "default",
+			input,
+			in: options.in,
+			out: options.out,
+			annotate: options.annotate ?? false
+		},
+		stdinContent
+	});
+	if (!result.ok) {
+		console.error(`Error: ${result.error.message}`);
+		process.exit(1);
+	}
+	writeOutput(result.value.output, result.value.isBinary);
+});
+program.command("array").description("Compose a dCBOR array from the provided elements").argument("<elements...>", "Each element is parsed as a dCBOR item in diagnostic notation").addOption(new commander.Option("-o, --out <format>", "The output format").choices([
+	"diag",
+	"hex",
+	"bin",
+	"none"
+]).default("hex")).option("-a, --annotate", "Output diagnostic notation or hexadecimal with annotations").action((elements, options) => {
+	const result = require_src.run({ command: {
+		type: "array",
+		elements,
+		out: options.out,
+		annotate: options.annotate ?? false
+	} });
+	if (!result.ok) {
+		console.error(`Error: ${result.error.message}`);
+		process.exit(1);
+	}
+	writeOutput(result.value.output, result.value.isBinary);
+});
+program.command("map").description("Compose a dCBOR map from the provided keys and values").argument("<pairs...>", "Each alternating key and value is parsed as a dCBOR item in diagnostic notation").addOption(new commander.Option("-o, --out <format>", "The output format").choices([
+	"diag",
+	"hex",
+	"bin",
+	"none"
+]).default("hex")).option("-a, --annotate", "Output diagnostic notation or hexadecimal with annotations").action((pairs, options) => {
+	const result = require_src.run({ command: {
+		type: "map",
+		kvPairs: pairs,
+		out: options.out,
+		annotate: options.annotate ?? false
+	} });
+	if (!result.ok) {
+		console.error(`Error: ${result.error.message}`);
+		process.exit(1);
+	}
+	writeOutput(result.value.output, result.value.isBinary);
+});
+program.command("match").description("Match dCBOR data against a pattern").argument("<pattern>", "The pattern to match against").argument("[input]", "dCBOR input (hex, diag, or binary). If not provided, reads from stdin").addOption(new commander.Option("-i, --in <format>", "Input format").choices([
+	"diag",
+	"hex",
+	"bin"
+]).default("diag")).addOption(new commander.Option("-o, --out <format>", "Output format").choices([
+	"paths",
+	"diag",
+	"hex",
+	"bin"
+]).default("paths")).option("--no-indent", "Disable indentation of path elements").option("--last-only", "Show only the last element of each path").option("--annotate", "Add annotations to output").option("--captures", "Include capture information in output").action(async (pattern, input, options) => {
+	let stdinContent;
+	if (input === void 0) stdinContent = await readStdin();
+	const result = require_src.run({
+		command: {
+			type: "match",
+			pattern,
+			input,
+			in: options.in,
+			out: options.out,
+			noIndent: !options.indent,
+			lastOnly: options.lastOnly ?? false,
+			annotate: options.annotate ?? false,
+			captures: options.captures ?? false
+		},
+		stdinContent
+	});
+	if (!result.ok) {
+		console.error(`Error: ${result.error.message}`);
+		process.exit(1);
+	}
+	writeOutput(result.value.output, result.value.isBinary);
+});
+/**
+* Read from stdin
+*/
+async function readStdin() {
+	if (process.stdin.isTTY) return "";
+	const chunks = [];
+	for await (const chunk of process.stdin) chunks.push(chunk);
+	return Buffer.concat(chunks).toString("utf8");
+}
+/**
+* Write output to stdout
+*/
+function writeOutput(output, isBinary) {
+	if (isBinary) {
+		const bytes = Buffer.from(output, "hex");
+		process.stdout.write(bytes);
+	} else if (output.length > 0) console.log(output);
+}
+program.parse();
+
+//#endregion
+//# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.cjs","names":["Command","VERSION","Option","stdinContent: string | undefined","run","chunks: Buffer[]"],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/* eslint-disable no-console, no-undef, no-restricted-globals, @typescript-eslint/no-unsafe-argument */\n/**\n * dcbor CLI - Command line parser/validator for deterministic CBOR (dCBOR)\n *\n * A command line tool for composing, parsing and validating Gordian dCBOR.\n * See the main repo README: https://github.com/leonardocustodio/bcts\n */\n\nimport { Command, Option } from \"commander\";\nimport { VERSION } from \"./index.js\";\nimport { run, type Command as CmdType } from \"./run.js\";\nimport type { InputFormat, OutputFormat } from \"./format.js\";\nimport type { MatchOutputFormat } from \"./cmd/match.js\";\n\nconst program = new Command();\n\nprogram\n  .name(\"dcbor\")\n  .description(\"Command line parser/validator for deterministic CBOR (dCBOR)\")\n  .version(VERSION);\n\n// Default command arguments (when no subcommand is provided)\nprogram\n  .argument(\"[input]\", \"Input dCBOR in the format specified by --in\")\n  .addOption(\n    new Option(\"-i, --in <format>\", \"The input format\")\n      .choices([\"diag\", \"hex\", \"bin\"])\n      .default(\"diag\"),\n  )\n  .addOption(\n    new Option(\"-o, --out <format>\", \"The output format\")\n      .choices([\"diag\", \"hex\", \"bin\", \"none\"])\n      .default(\"hex\"),\n  )\n  .option(\"-a, --annotate\", \"Output diagnostic notation or hexadecimal with annotations\")\n  .action(\n    async (\n      input: string | undefined,\n      options: {\n        in: InputFormat;\n        out: OutputFormat;\n        annotate?: boolean;\n      },\n    ) => {\n      // Read stdin if needed\n      let stdinContent: string | undefined;\n      if (input === undefined && options.in !== \"bin\") {\n        stdinContent = await readStdin();\n      } else if (options.in === \"bin\") {\n        stdinContent = await readStdin();\n      }\n\n      const command: CmdType = {\n        type: \"default\",\n        input,\n        in: options.in,\n        out: options.out,\n        annotate: options.annotate ?? false,\n      };\n\n      const result = run({ command, stdinContent });\n\n      if (!result.ok) {\n        console.error(`Error: ${result.error.message}`);\n        process.exit(1);\n      }\n\n      writeOutput(result.value.output, result.value.isBinary);\n    },\n  );\n\n// Array subcommand\nprogram\n  .command(\"array\")\n  .description(\"Compose a dCBOR array from the provided elements\")\n  .argument(\"<elements...>\", \"Each element is parsed as a dCBOR item in diagnostic notation\")\n  .addOption(\n    new Option(\"-o, --out <format>\", \"The output format\")\n      .choices([\"diag\", \"hex\", \"bin\", \"none\"])\n      .default(\"hex\"),\n  )\n  .option(\"-a, --annotate\", \"Output diagnostic notation or hexadecimal with annotations\")\n  .action(\n    (\n      elements: string[],\n      options: {\n        out: OutputFormat;\n        annotate?: boolean;\n      },\n    ) => {\n      const command: CmdType = {\n        type: \"array\",\n        elements,\n        out: options.out,\n        annotate: options.annotate ?? false,\n      };\n\n      const result = run({ command });\n\n      if (!result.ok) {\n        console.error(`Error: ${result.error.message}`);\n        process.exit(1);\n      }\n\n      writeOutput(result.value.output, result.value.isBinary);\n    },\n  );\n\n// Map subcommand\nprogram\n  .command(\"map\")\n  .description(\"Compose a dCBOR map from the provided keys and values\")\n  .argument(\n    \"<pairs...>\",\n    \"Each alternating key and value is parsed as a dCBOR item in diagnostic notation\",\n  )\n  .addOption(\n    new Option(\"-o, --out <format>\", \"The output format\")\n      .choices([\"diag\", \"hex\", \"bin\", \"none\"])\n      .default(\"hex\"),\n  )\n  .option(\"-a, --annotate\", \"Output diagnostic notation or hexadecimal with annotations\")\n  .action(\n    (\n      pairs: string[],\n      options: {\n        out: OutputFormat;\n        annotate?: boolean;\n      },\n    ) => {\n      const command: CmdType = {\n        type: \"map\",\n        kvPairs: pairs,\n        out: options.out,\n        annotate: options.annotate ?? false,\n      };\n\n      const result = run({ command });\n\n      if (!result.ok) {\n        console.error(`Error: ${result.error.message}`);\n        process.exit(1);\n      }\n\n      writeOutput(result.value.output, result.value.isBinary);\n    },\n  );\n\n// Match subcommand\nprogram\n  .command(\"match\")\n  .description(\"Match dCBOR data against a pattern\")\n  .argument(\"<pattern>\", \"The pattern to match against\")\n  .argument(\"[input]\", \"dCBOR input (hex, diag, or binary). If not provided, reads from stdin\")\n  .addOption(\n    new Option(\"-i, --in <format>\", \"Input format\").choices([\"diag\", \"hex\", \"bin\"]).default(\"diag\"),\n  )\n  .addOption(\n    new Option(\"-o, --out <format>\", \"Output format\")\n      .choices([\"paths\", \"diag\", \"hex\", \"bin\"])\n      .default(\"paths\"),\n  )\n  .option(\"--no-indent\", \"Disable indentation of path elements\")\n  .option(\"--last-only\", \"Show only the last element of each path\")\n  .option(\"--annotate\", \"Add annotations to output\")\n  .option(\"--captures\", \"Include capture information in output\")\n  .action(\n    async (\n      pattern: string,\n      input: string | undefined,\n      options: {\n        in: InputFormat;\n        out: MatchOutputFormat;\n        indent: boolean;\n        lastOnly?: boolean;\n        annotate?: boolean;\n        captures?: boolean;\n      },\n    ) => {\n      // Read stdin if needed\n      let stdinContent: string | undefined;\n      if (input === undefined) {\n        stdinContent = await readStdin();\n      }\n\n      const command: CmdType = {\n        type: \"match\",\n        pattern,\n        input,\n        in: options.in,\n        out: options.out,\n        noIndent: !options.indent,\n        lastOnly: options.lastOnly ?? false,\n        annotate: options.annotate ?? false,\n        captures: options.captures ?? false,\n      };\n\n      const result = run({ command, stdinContent });\n\n      if (!result.ok) {\n        console.error(`Error: ${result.error.message}`);\n        process.exit(1);\n      }\n\n      writeOutput(result.value.output, result.value.isBinary);\n    },\n  );\n\n/**\n * Read from stdin\n */\nasync function readStdin(): Promise<string> {\n  // Check if stdin is a TTY (interactive terminal)\n  if (process.stdin.isTTY) {\n    return \"\";\n  }\n\n  const chunks: Buffer[] = [];\n  for await (const chunk of process.stdin) {\n    chunks.push(chunk);\n  }\n  return Buffer.concat(chunks).toString(\"utf8\");\n}\n\n/**\n * Write output to stdout\n */\nfunction writeOutput(output: string, isBinary: boolean): void {\n  if (isBinary) {\n    // For binary output, decode hex back to bytes\n    const bytes = Buffer.from(output, \"hex\");\n    process.stdout.write(bytes);\n  } else if (output.length > 0) {\n    console.log(output);\n  }\n}\n\nprogram.parse();\n"],"mappings":"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"}

package/dist/cli.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/cli.mjs

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+import { n as run, t as VERSION } from "./src-Ce085uR8.mjs";
+import { Command, Option } from "commander";
+
+//#region src/cli.ts
+/**
+* dcbor CLI - Command line parser/validator for deterministic CBOR (dCBOR)
+*
+* A command line tool for composing, parsing and validating Gordian dCBOR.
+* See the main repo README: https://github.com/leonardocustodio/bcts
+*/
+const program = new Command();
+program.name("dcbor").description("Command line parser/validator for deterministic CBOR (dCBOR)").version(VERSION);
+program.argument("[input]", "Input dCBOR in the format specified by --in").addOption(new Option("-i, --in <format>", "The input format").choices([
+	"diag",
+	"hex",
+	"bin"
+]).default("diag")).addOption(new Option("-o, --out <format>", "The output format").choices([
+	"diag",
+	"hex",
+	"bin",
+	"none"
+]).default("hex")).option("-a, --annotate", "Output diagnostic notation or hexadecimal with annotations").action(async (input, options) => {
+	let stdinContent;
+	if (input === void 0 && options.in !== "bin") stdinContent = await readStdin();
+	else if (options.in === "bin") stdinContent = await readStdin();
+	const result = run({
+		command: {
+			type: "default",
+			input,
+			in: options.in,
+			out: options.out,
+			annotate: options.annotate ?? false
+		},
+		stdinContent
+	});
+	if (!result.ok) {
+		console.error(`Error: ${result.error.message}`);
+		process.exit(1);
+	}
+	writeOutput(result.value.output, result.value.isBinary);
+});
+program.command("array").description("Compose a dCBOR array from the provided elements").argument("<elements...>", "Each element is parsed as a dCBOR item in diagnostic notation").addOption(new Option("-o, --out <format>", "The output format").choices([
+	"diag",
+	"hex",
+	"bin",
+	"none"
+]).default("hex")).option("-a, --annotate", "Output diagnostic notation or hexadecimal with annotations").action((elements, options) => {
+	const result = run({ command: {
+		type: "array",
+		elements,
+		out: options.out,
+		annotate: options.annotate ?? false
+	} });
+	if (!result.ok) {
+		console.error(`Error: ${result.error.message}`);
+		process.exit(1);
+	}
+	writeOutput(result.value.output, result.value.isBinary);
+});
+program.command("map").description("Compose a dCBOR map from the provided keys and values").argument("<pairs...>", "Each alternating key and value is parsed as a dCBOR item in diagnostic notation").addOption(new Option("-o, --out <format>", "The output format").choices([
+	"diag",
+	"hex",
+	"bin",
+	"none"
+]).default("hex")).option("-a, --annotate", "Output diagnostic notation or hexadecimal with annotations").action((pairs, options) => {
+	const result = run({ command: {
+		type: "map",
+		kvPairs: pairs,
+		out: options.out,
+		annotate: options.annotate ?? false
+	} });
+	if (!result.ok) {
+		console.error(`Error: ${result.error.message}`);
+		process.exit(1);
+	}
+	writeOutput(result.value.output, result.value.isBinary);
+});
+program.command("match").description("Match dCBOR data against a pattern").argument("<pattern>", "The pattern to match against").argument("[input]", "dCBOR input (hex, diag, or binary). If not provided, reads from stdin").addOption(new Option("-i, --in <format>", "Input format").choices([
+	"diag",
+	"hex",
+	"bin"
+]).default("diag")).addOption(new Option("-o, --out <format>", "Output format").choices([
+	"paths",
+	"diag",
+	"hex",
+	"bin"
+]).default("paths")).option("--no-indent", "Disable indentation of path elements").option("--last-only", "Show only the last element of each path").option("--annotate", "Add annotations to output").option("--captures", "Include capture information in output").action(async (pattern, input, options) => {
+	let stdinContent;
+	if (input === void 0) stdinContent = await readStdin();
+	const result = run({
+		command: {
+			type: "match",
+			pattern,
+			input,
+			in: options.in,
+			out: options.out,
+			noIndent: !options.indent,
+			lastOnly: options.lastOnly ?? false,
+			annotate: options.annotate ?? false,
+			captures: options.captures ?? false
+		},
+		stdinContent
+	});
+	if (!result.ok) {
+		console.error(`Error: ${result.error.message}`);
+		process.exit(1);
+	}
+	writeOutput(result.value.output, result.value.isBinary);
+});
+/**
+* Read from stdin
+*/
+async function readStdin() {
+	if (process.stdin.isTTY) return "";
+	const chunks = [];
+	for await (const chunk of process.stdin) chunks.push(chunk);
+	return Buffer.concat(chunks).toString("utf8");
+}
+/**
+* Write output to stdout
+*/
+function writeOutput(output, isBinary) {
+	if (isBinary) {
+		const bytes = Buffer.from(output, "hex");
+		process.stdout.write(bytes);
+	} else if (output.length > 0) console.log(output);
+}
+program.parse();
+
+//#endregion
+export {  };
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":["stdinContent: string | undefined","chunks: Buffer[]"],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/* eslint-disable no-console, no-undef, no-restricted-globals, @typescript-eslint/no-unsafe-argument */\n/**\n * dcbor CLI - Command line parser/validator for deterministic CBOR (dCBOR)\n *\n * A command line tool for composing, parsing and validating Gordian dCBOR.\n * See the main repo README: https://github.com/leonardocustodio/bcts\n */\n\nimport { Command, Option } from \"commander\";\nimport { VERSION } from \"./index.js\";\nimport { run, type Command as CmdType } from \"./run.js\";\nimport type { InputFormat, OutputFormat } from \"./format.js\";\nimport type { MatchOutputFormat } from \"./cmd/match.js\";\n\nconst program = new Command();\n\nprogram\n  .name(\"dcbor\")\n  .description(\"Command line parser/validator for deterministic CBOR (dCBOR)\")\n  .version(VERSION);\n\n// Default command arguments (when no subcommand is provided)\nprogram\n  .argument(\"[input]\", \"Input dCBOR in the format specified by --in\")\n  .addOption(\n    new Option(\"-i, --in <format>\", \"The input format\")\n      .choices([\"diag\", \"hex\", \"bin\"])\n      .default(\"diag\"),\n  )\n  .addOption(\n    new Option(\"-o, --out <format>\", \"The output format\")\n      .choices([\"diag\", \"hex\", \"bin\", \"none\"])\n      .default(\"hex\"),\n  )\n  .option(\"-a, --annotate\", \"Output diagnostic notation or hexadecimal with annotations\")\n  .action(\n    async (\n      input: string | undefined,\n      options: {\n        in: InputFormat;\n        out: OutputFormat;\n        annotate?: boolean;\n      },\n    ) => {\n      // Read stdin if needed\n      let stdinContent: string | undefined;\n      if (input === undefined && options.in !== \"bin\") {\n        stdinContent = await readStdin();\n      } else if (options.in === \"bin\") {\n        stdinContent = await readStdin();\n      }\n\n      const command: CmdType = {\n        type: \"default\",\n        input,\n        in: options.in,\n        out: options.out,\n        annotate: options.annotate ?? false,\n      };\n\n      const result = run({ command, stdinContent });\n\n      if (!result.ok) {\n        console.error(`Error: ${result.error.message}`);\n        process.exit(1);\n      }\n\n      writeOutput(result.value.output, result.value.isBinary);\n    },\n  );\n\n// Array subcommand\nprogram\n  .command(\"array\")\n  .description(\"Compose a dCBOR array from the provided elements\")\n  .argument(\"<elements...>\", \"Each element is parsed as a dCBOR item in diagnostic notation\")\n  .addOption(\n    new Option(\"-o, --out <format>\", \"The output format\")\n      .choices([\"diag\", \"hex\", \"bin\", \"none\"])\n      .default(\"hex\"),\n  )\n  .option(\"-a, --annotate\", \"Output diagnostic notation or hexadecimal with annotations\")\n  .action(\n    (\n      elements: string[],\n      options: {\n        out: OutputFormat;\n        annotate?: boolean;\n      },\n    ) => {\n      const command: CmdType = {\n        type: \"array\",\n        elements,\n        out: options.out,\n        annotate: options.annotate ?? false,\n      };\n\n      const result = run({ command });\n\n      if (!result.ok) {\n        console.error(`Error: ${result.error.message}`);\n        process.exit(1);\n      }\n\n      writeOutput(result.value.output, result.value.isBinary);\n    },\n  );\n\n// Map subcommand\nprogram\n  .command(\"map\")\n  .description(\"Compose a dCBOR map from the provided keys and values\")\n  .argument(\n    \"<pairs...>\",\n    \"Each alternating key and value is parsed as a dCBOR item in diagnostic notation\",\n  )\n  .addOption(\n    new Option(\"-o, --out <format>\", \"The output format\")\n      .choices([\"diag\", \"hex\", \"bin\", \"none\"])\n      .default(\"hex\"),\n  )\n  .option(\"-a, --annotate\", \"Output diagnostic notation or hexadecimal with annotations\")\n  .action(\n    (\n      pairs: string[],\n      options: {\n        out: OutputFormat;\n        annotate?: boolean;\n      },\n    ) => {\n      const command: CmdType = {\n        type: \"map\",\n        kvPairs: pairs,\n        out: options.out,\n        annotate: options.annotate ?? false,\n      };\n\n      const result = run({ command });\n\n      if (!result.ok) {\n        console.error(`Error: ${result.error.message}`);\n        process.exit(1);\n      }\n\n      writeOutput(result.value.output, result.value.isBinary);\n    },\n  );\n\n// Match subcommand\nprogram\n  .command(\"match\")\n  .description(\"Match dCBOR data against a pattern\")\n  .argument(\"<pattern>\", \"The pattern to match against\")\n  .argument(\"[input]\", \"dCBOR input (hex, diag, or binary). If not provided, reads from stdin\")\n  .addOption(\n    new Option(\"-i, --in <format>\", \"Input format\").choices([\"diag\", \"hex\", \"bin\"]).default(\"diag\"),\n  )\n  .addOption(\n    new Option(\"-o, --out <format>\", \"Output format\")\n      .choices([\"paths\", \"diag\", \"hex\", \"bin\"])\n      .default(\"paths\"),\n  )\n  .option(\"--no-indent\", \"Disable indentation of path elements\")\n  .option(\"--last-only\", \"Show only the last element of each path\")\n  .option(\"--annotate\", \"Add annotations to output\")\n  .option(\"--captures\", \"Include capture information in output\")\n  .action(\n    async (\n      pattern: string,\n      input: string | undefined,\n      options: {\n        in: InputFormat;\n        out: MatchOutputFormat;\n        indent: boolean;\n        lastOnly?: boolean;\n        annotate?: boolean;\n        captures?: boolean;\n      },\n    ) => {\n      // Read stdin if needed\n      let stdinContent: string | undefined;\n      if (input === undefined) {\n        stdinContent = await readStdin();\n      }\n\n      const command: CmdType = {\n        type: \"match\",\n        pattern,\n        input,\n        in: options.in,\n        out: options.out,\n        noIndent: !options.indent,\n        lastOnly: options.lastOnly ?? false,\n        annotate: options.annotate ?? false,\n        captures: options.captures ?? false,\n      };\n\n      const result = run({ command, stdinContent });\n\n      if (!result.ok) {\n        console.error(`Error: ${result.error.message}`);\n        process.exit(1);\n      }\n\n      writeOutput(result.value.output, result.value.isBinary);\n    },\n  );\n\n/**\n * Read from stdin\n */\nasync function readStdin(): Promise<string> {\n  // Check if stdin is a TTY (interactive terminal)\n  if (process.stdin.isTTY) {\n    return \"\";\n  }\n\n  const chunks: Buffer[] = [];\n  for await (const chunk of process.stdin) {\n    chunks.push(chunk);\n  }\n  return Buffer.concat(chunks).toString(\"utf8\");\n}\n\n/**\n * Write output to stdout\n */\nfunction writeOutput(output: string, isBinary: boolean): void {\n  if (isBinary) {\n    // For binary output, decode hex back to bytes\n    const bytes = Buffer.from(output, \"hex\");\n    process.stdout.write(bytes);\n  } else if (output.length > 0) {\n    console.log(output);\n  }\n}\n\nprogram.parse();\n"],"mappings":"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"}

package/dist/index.cjs

@@ -0,0 +1,16 @@
+const require_src = require('./src-M5HM-SCU.cjs');
+
+exports.VERSION = require_src.VERSION;
+exports.createArrayCommand = require_src.createArrayCommand;
+exports.createDefaultCommand = require_src.createDefaultCommand;
+exports.createMapCommand = require_src.createMapCommand;
+exports.createMatchCommand = require_src.createMatchCommand;
+exports.execArray = require_src.execArray;
+exports.execDefault = require_src.execDefault;
+exports.execDefaultWithReader = require_src.execDefaultWithReader;
+exports.execMap = require_src.execMap;
+exports.execMatch = require_src.execMatch;
+exports.formatOutput = require_src.formatOutput;
+exports.readData = require_src.readData;
+exports.readString = require_src.readString;
+exports.run = require_src.run;