@did-btcr2/cli 0.5.1 → 0.6.0

package/src/commands/deactivate.ts

@@ -1,15 +1,15 @@
-import type { DidBtcr2Api } from '@did-btcr2/api';
-import { Command } from 'commander';
+import type { Command } from 'commander';
+import { deriveNetwork, type ApiFactory } from '../config.js';
 import { CLIError } from '../error.js';
 import { formatResult } from '../output.js';
-import { GlobalOptions, UpdateCommandOptions } from '../types.js';
+import type { GlobalOptions, UpdateCommandOptions } from '../types.js';
 
 /** The JSON Patch that marks a DID document as permanently deactivated. */
 const DEACTIVATION_PATCH = [{ op: 'add' as const, path: '/deactivated', value: true }];
 
 export function registerDeactivateCommand(
   program : Command,
-  api     : DidBtcr2Api,
+  factory : ApiFactory,
   globals : () => GlobalOptions,
 ): void {
   program
@@ -47,6 +47,16 @@ export function registerDeactivateCommand(
         verificationMethodId : options.verificationMethodId,
         beaconId             : options.beaconId as UpdateCommandOptions['beaconId'],
       };
+      const did = parsed.sourceDocument?.id;
+      if (!did) {
+        throw new CLIError(
+          'Source document must contain an "id" field.',
+          'INVALID_ARGUMENT_ERROR',
+          options
+        );
+      }
+      const network = deriveNetwork(did);
+      const api = factory(network, globals());
       const data = await api.btcr2.update(parsed);
       const result = { action: 'deactivate' as const, data };
       console.log(formatResult(result, globals()));

package/src/commands/resolve.ts

@@ -1,14 +1,14 @@
-import type { DidBtcr2Api } from '@did-btcr2/api';
 import { Identifier } from '@did-btcr2/api';
-import { Command } from 'commander';
+import type { Command } from 'commander';
 import { readFile } from 'node:fs/promises';
+import { deriveNetwork, type ApiFactory } from '../config.js';
 import { CLIError } from '../error.js';
 import { formatResult } from '../output.js';
-import { GlobalOptions, ResolveCommandOptions } from '../types.js';
+import type { GlobalOptions, ResolveCommandOptions } from '../types.js';
 
 export function registerResolveCommand(
   program : Command,
-  api     : DidBtcr2Api,
+  factory : ApiFactory,
   globals : () => GlobalOptions,
 ): void {
   program
@@ -24,6 +24,8 @@ export function registerResolveCommand(
       resolutionOptionsPath?: string;
     }) => {
       const parsed = await validateResolveOptions(options);
+      const network = deriveNetwork(parsed.identifier);
+      const api = factory(network, globals());
       const data = await api.resolveDid(parsed.identifier, parsed.options);
       const result = { action: 'resolve' as const, data };
       console.log(formatResult(result, globals()));

package/src/commands/update.ts

@@ -1,12 +1,12 @@
-import type { DidBtcr2Api } from '@did-btcr2/api';
-import { Command } from 'commander';
+import type { Command } from 'commander';
+import { deriveNetwork, type ApiFactory } from '../config.js';
 import { CLIError } from '../error.js';
 import { formatResult } from '../output.js';
-import { GlobalOptions, UpdateCommandOptions } from '../types.js';
+import type { GlobalOptions, UpdateCommandOptions } from '../types.js';
 
 export function registerUpdateCommand(
   program : Command,
-  api     : DidBtcr2Api,
+  factory : ApiFactory,
   globals : () => GlobalOptions,
 ): void {
   program
@@ -49,6 +49,16 @@ export function registerUpdateCommand(
         verificationMethodId : options.verificationMethodId,
         beaconId             : options.beaconId as UpdateCommandOptions['beaconId'],
       };
+      const did = parsed.sourceDocument?.id;
+      if (!did) {
+        throw new CLIError(
+          'Source document must contain an "id" field.',
+          'INVALID_ARGUMENT_ERROR',
+          options
+        );
+      }
+      const network = deriveNetwork(did);
+      const api = factory(network, globals());
       const data = await api.btcr2.update(parsed);
       const result = { action: 'update' as const, data };
       console.log(formatResult(result, globals()));

package/src/config.ts

@@ -0,0 +1,226 @@
+import { createApi, Identifier, type BitcoinApiConfig, type DidBtcr2Api } from '@did-btcr2/api';
+import { readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { CLIError } from './error.js';
+import { SUPPORTED_NETWORKS, type NetworkOption } from './types.js';
+
+/**
+ * Endpoint overrides provided via CLI flags, env vars, or config file.
+ * These override the per-network defaults from
+ * `DEFAULT_BITCOIN_NETWORK_CONFIG`.
+ *
+ * `config` and `profile` control config-file resolution and are only
+ * meaningful when passed through the full merge chain.
+ */
+export type ConnectionOverrides = {
+  btcRest?   : string;
+  btcRpcUrl? : string;
+  btcRpcUser?: string;
+  btcRpcPass?: string;
+  casGateway?: string;
+  config?    : string;
+  profile?   : string;
+};
+
+/**
+ * On-disk config file schema.
+ *
+ * @example
+ * ```json
+ * {
+ *   "profiles": {
+ *     "regtest": {
+ *       "btc": {
+ *         "rest": "http://localhost:3000",
+ *         "rpcUrl": "http://localhost:18443",
+ *         "rpcUser": "polaruser",
+ *         "rpcPass": "polarpass"
+ *       }
+ *     },
+ *     "bitcoin": {
+ *       "btc": { "rest": "https://my-mempool/api" },
+ *       "cas": { "gateway": "https://ipfs.io" }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export type ConfigFile = {
+  profiles?: Record<string, {
+    btc?: {
+      rest?    : string;
+      rpcUrl?  : string;
+      rpcUser? : string;
+      rpcPass? : string;
+    };
+    cas?: {
+      gateway?: string;
+    };
+  }>;
+};
+
+/**
+ * Factory function that creates a configured {@link DidBtcr2Api} instance.
+ *
+ * When `network` is provided, the returned API is wired to that network's
+ * default Bitcoin endpoints (mempool.space for public networks, localhost
+ * Polar for regtest). Optional `overrides` let callers replace individual
+ * endpoints on top of the defaults. When `network` is omitted, no Bitcoin
+ * or CAS is configured — suitable for offline operations like `create`.
+ */
+export type ApiFactory = (network?: NetworkOption, overrides?: ConnectionOverrides) => DidBtcr2Api;
+
+/**
+ * Environment variable names consulted by {@link defaultApiFactory}.
+ *
+ * | Variable              | Equivalent flag    |
+ * |-----------------------|--------------------|
+ * | `BTCR2_BTC_REST`      | `--btc-rest`       |
+ * | `BTCR2_BTC_RPC_URL`   | `--btc-rpc-url`    |
+ * | `BTCR2_BTC_RPC_USER`  | `--btc-rpc-user`   |
+ * | `BTCR2_BTC_RPC_PASS`  | `--btc-rpc-pass`   |
+ * | `BTCR2_CAS_GATEWAY`   | `--cas-gateway`    |
+ */
+export const ENV_VARS = {
+  BTC_REST     : 'BTCR2_BTC_REST',
+  BTC_RPC_URL  : 'BTCR2_BTC_RPC_URL',
+  BTC_RPC_USER : 'BTCR2_BTC_RPC_USER',
+  BTC_RPC_PASS : 'BTCR2_BTC_RPC_PASS',
+  CAS_GATEWAY  : 'BTCR2_CAS_GATEWAY',
+} as const;
+
+/**
+ * Reads {@link ConnectionOverrides} from environment variables.
+ * Only defined (non-empty) values are included.
+ */
+export function readEnvOverrides(): ConnectionOverrides {
+  const env = (key: string): string | undefined => process.env[key] || undefined;
+  return {
+    btcRest    : env(ENV_VARS.BTC_REST),
+    btcRpcUrl  : env(ENV_VARS.BTC_RPC_URL),
+    btcRpcUser : env(ENV_VARS.BTC_RPC_USER),
+    btcRpcPass : env(ENV_VARS.BTC_RPC_PASS),
+    casGateway : env(ENV_VARS.CAS_GATEWAY),
+  };
+}
+
+/**
+ * Default config file path following the XDG Base Directory Specification.
+ *
+ * Resolution order:
+ * 1. `$XDG_CONFIG_HOME/btcr2/config.json`
+ * 2. `%APPDATA%/btcr2/config.json` (Windows)
+ * 3. `~/.config/btcr2/config.json` (fallback)
+ */
+export function defaultConfigPath(): string {
+  const base = process.env.XDG_CONFIG_HOME
+    ?? process.env.APPDATA
+    ?? join(homedir(), '.config');
+  return join(base, 'btcr2', 'config.json');
+}
+
+/**
+ * Reads and parses a config file. Returns `undefined` if the file does
+ * not exist or cannot be parsed.
+ */
+export function readConfigFile(path: string): ConfigFile | undefined {
+  try {
+    const content = readFileSync(path, 'utf-8');
+    return JSON.parse(content) as ConfigFile;
+  } catch {
+    return undefined;
+  }
+}
+
+/**
+ * Extracts {@link ConnectionOverrides} from a named profile in a
+ * {@link ConfigFile}. Returns an empty object if the profile does not exist.
+ */
+export function profileToOverrides(
+  config      : ConfigFile,
+  profileName : string,
+): ConnectionOverrides {
+  const profile = config.profiles?.[profileName];
+  if (!profile) return {};
+  return {
+    btcRest    : profile.btc?.rest,
+    btcRpcUrl  : profile.btc?.rpcUrl,
+    btcRpcUser : profile.btc?.rpcUser,
+    btcRpcPass : profile.btc?.rpcPass,
+    casGateway : profile.cas?.gateway,
+  };
+}
+
+/**
+ * Default {@link ApiFactory} backed by network defaults from
+ * `@did-btcr2/bitcoin` (mempool.space for public networks, localhost for
+ * regtest).
+ *
+ * Override precedence (highest wins):
+ * CLI flags → env vars → config file profile → network defaults.
+ *
+ * When no `--profile` is given, the network name is used as the profile
+ * key (e.g. a regtest DID auto-selects the `"regtest"` profile).
+ */
+export function defaultApiFactory(network?: NetworkOption, overrides?: ConnectionOverrides): DidBtcr2Api {
+  if (!network) return createApi();
+
+  // Layer 1: Config file profile (lowest precedence of the three override layers)
+  const configPath = overrides?.config ?? defaultConfigPath();
+  const profileName = overrides?.profile ?? network;
+  const file = readConfigFile(configPath);
+  const fileOverrides = file ? profileToOverrides(file, profileName) : {};
+
+  // Layer 2: Environment variables
+  const env = readEnvOverrides();
+
+  // Merge: CLI flags → env vars → config file → (network defaults handled by BitcoinConnection)
+  const merged: ConnectionOverrides = {
+    btcRest    : overrides?.btcRest    ?? env.btcRest    ?? fileOverrides.btcRest,
+    btcRpcUrl  : overrides?.btcRpcUrl  ?? env.btcRpcUrl  ?? fileOverrides.btcRpcUrl,
+    btcRpcUser : overrides?.btcRpcUser ?? env.btcRpcUser ?? fileOverrides.btcRpcUser,
+    btcRpcPass : overrides?.btcRpcPass ?? env.btcRpcPass ?? fileOverrides.btcRpcPass,
+    casGateway : overrides?.casGateway ?? env.casGateway ?? fileOverrides.casGateway,
+  };
+
+  const btc: BitcoinApiConfig = { network };
+
+  if (merged.btcRest) {
+    btc.rest = { host: merged.btcRest };
+  }
+
+  if (merged.btcRpcUrl) {
+    btc.rpc = {
+      host     : merged.btcRpcUrl,
+      username : merged.btcRpcUser,
+      password : merged.btcRpcPass,
+    };
+  }
+
+  const cas = merged.casGateway ? { gateway: merged.casGateway } : undefined;
+
+  return createApi({ btc, ...(cas && { cas }) });
+}
+
+/**
+ * Extracts and validates the Bitcoin network from a DID string.
+ *
+ * Decodes the DID via {@link Identifier.decode}, then checks that the
+ * embedded network is one of the supported values.
+ *
+ * @param did A `did:btcr2:...` identifier string.
+ * @returns The validated {@link NetworkOption}.
+ * @throws {CLIError} If the network is unsupported.
+ */
+export function deriveNetwork(did: string): NetworkOption {
+  const { network } = Identifier.decode(did);
+  if (!SUPPORTED_NETWORKS.includes(network as NetworkOption)) {
+    throw new CLIError(
+      `Unsupported network "${network}" in DID.`,
+      'INVALID_ARGUMENT_ERROR',
+      { did, network }
+    );
+  }
+  return network as NetworkOption;
+}

package/src/index.ts

@@ -1,5 +1,6 @@
 export * from './cli.js';
 export * from './commands/index.js';
+export * from './config.js';
 export * from './error.js';
 export * from './output.js';
 export * from './types.js';

package/src/output.ts

@@ -1,4 +1,4 @@
-import { CommandResult, GlobalOptions } from './types.js';
+import type { CommandResult, GlobalOptions } from './types.js';
 
 /**
  * Formats a CommandResult for console output.

package/src/types.ts

@@ -36,7 +36,14 @@ export type CommandResult =
   | { action: 'deactivate'; data: SignedBTCR2Update };
 
 export interface GlobalOptions {
-  output  : OutputFormat;
-  verbose : boolean;
-  quiet   : boolean;
+  output     : OutputFormat;
+  verbose    : boolean;
+  quiet      : boolean;
+  config?    : string;
+  profile?   : string;
+  btcRest?   : string;
+  btcRpcUrl? : string;
+  btcRpcUser?: string;
+  btcRpcPass?: string;
+  casGateway?: string;
 }

package/dist/cjs/cli.js

@@ -1,77 +0,0 @@
-import { Command, CommanderError } from 'commander';
-import { createApi } from '@did-btcr2/api';
-import { registerCreateCommand, registerDeactivateCommand, registerResolveCommand, registerUpdateCommand, } from './commands/index.js';
-import { CLIError } from './error.js';
-import { VERSION } from './version.js';
-/**
- * CLI tool for the did:btcr2 method.
- */
-export class DidBtcr2Cli {
-    program;
-    api;
-    /**
-     * Initializes the CLI with an optional pre-configured API instance.
-     * @param {DidBtcr2Api} api - Optional API instance. Defaults to an unconfigured instance.
-     */
-    constructor(api = createApi()) {
-        this.api = api;
-        this.program = new Command('btcr2')
-            .version(`btcr2 ${VERSION}`, '-v, --version', 'Output the current version')
-            .description('CLI tool for the did:btcr2 method')
-            .option('-o, --output <format>', 'Output format <json|text>', 'text')
-            .option('--verbose', 'Verbose output', false)
-            .option('--quiet', 'Suppress non-essential output', false);
-        const globals = () => this.program.opts();
-        registerCreateCommand(this.program, this.api, globals);
-        registerResolveCommand(this.program, this.api, globals);
-        registerUpdateCommand(this.program, this.api, globals);
-        registerDeactivateCommand(this.program, this.api, globals);
-    }
-    /**
-     * Runs the CLI with the provided argv or process.argv.
-     * @param {string[]} [argv] - Optional array of command-line arguments.
-     * @returns {Promise<void>} - Resolves when execution is complete.
-     */
-    async run(argv) {
-        try {
-            const normalized = normalizeArgv(argv ?? process.argv);
-            await this.program.parseAsync(normalized, { from: 'node' });
-            if (!this.program.args.length)
-                this.program.outputHelp();
-        }
-        catch (error) {
-            handleError(error);
-        }
-    }
-}
-/**
- * Normalizes argv to ensure it has at least two elements.
- * @param {string[]} argv - The original argv array.
- * @returns {string[]} - The normalized argv array.
- */
-function normalizeArgv(argv) {
-    if (argv.length >= 2)
-        return argv;
-    if (argv.length === 1)
-        return ['node', argv[0]];
-    return ['node', 'btcr2'];
-}
-/**
- * Handles errors thrown during CLI execution.
- * @param {unknown} error - The error to handle.
- * @returns {void}
- */
-function handleError(error) {
-    if (error instanceof CommanderError &&
-        (error.code === 'commander.helpDisplayed' || error.code === 'commander.help')) {
-        return;
-    }
-    if (error instanceof CLIError) {
-        console.error(error.message);
-        process.exitCode ??= 1;
-        return;
-    }
-    console.error(error);
-    process.exitCode ??= 1;
-}
-//# sourceMappingURL=cli.js.map

package/dist/cjs/cli.js.map

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

package/dist/cjs/commands/create.js

@@ -1,48 +0,0 @@
-import { CLIError } from '../error.js';
-import { formatResult } from '../output.js';
-import { SUPPORTED_NETWORKS, } from '../types.js';
-/** Expected byte length per identifier type: compressed secp256k1 = 33, SHA-256 hash = 32. */
-const EXPECTED_BYTES = {
-    k: { length: 33, label: 'secp256k1 compressed public key (33 bytes)' },
-    x: { length: 32, label: 'SHA-256 hash (32 bytes)' },
-};
-export function registerCreateCommand(program, api, globals) {
-    program
-        .command('create')
-        .description('Create an identifier and initial DID document')
-        .requiredOption('-t, --type <type>', 'Identifier type <k|x>', 'k')
-        .requiredOption('-n, --network <network>', 'Identifier bitcoin network <bitcoin|testnet3|testnet4|signet|mutinynet|regtest>')
-        .requiredOption('-b, --bytes <bytes>', 'Genesis bytes as a hex string. ' +
-        'If type=k, MUST be secp256k1 public key. ' +
-        'If type=x, MUST be SHA-256 hash of a genesis document')
-        .action(async (options) => {
-        const parsed = validateCreateOptions(options);
-        const type = parsed.type === 'k' ? 'deterministic' : 'external';
-        const genesisBytes = Buffer.from(parsed.bytes, 'hex');
-        const data = api.createDid(type, genesisBytes, { network: parsed.network });
-        const result = { action: 'create', data };
-        console.log(formatResult(result, globals()));
-    });
-}
-function validateCreateOptions(options) {
-    if (!['k', 'x'].includes(options.type)) {
-        throw new CLIError('Invalid type. Must be "k" or "x".', 'INVALID_ARGUMENT_ERROR', options);
-    }
-    if (!SUPPORTED_NETWORKS.includes(options.network)) {
-        throw new CLIError('Invalid network. Must be one of "bitcoin", "testnet3", "testnet4", "signet", "mutinynet", or "regtest".', 'INVALID_ARGUMENT_ERROR', options);
-    }
-    const buf = Buffer.from(options.bytes, 'hex');
-    if (buf.length === 0) {
-        throw new CLIError('Invalid bytes. Must be a non-empty hex string.', 'INVALID_ARGUMENT_ERROR', options);
-    }
-    const expected = EXPECTED_BYTES[options.type];
-    if (buf.length !== expected.length) {
-        throw new CLIError(`Invalid bytes length for type="${options.type}": expected ${expected.label}, got ${buf.length} bytes.`, 'INVALID_ARGUMENT_ERROR', options);
-    }
-    return {
-        type: options.type,
-        network: options.network,
-        bytes: options.bytes,
-    };
-}
-//# sourceMappingURL=create.js.map

package/dist/cjs/commands/create.js.map

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

package/dist/cjs/commands/deactivate.js

@@ -1,41 +0,0 @@
-import { CLIError } from '../error.js';
-import { formatResult } from '../output.js';
-/** The JSON Patch that marks a DID document as permanently deactivated. */
-const DEACTIVATION_PATCH = [{ op: 'add', path: '/deactivated', value: true }];
-export function registerDeactivateCommand(program, api, globals) {
-    program
-        .command('deactivate')
-        .alias('delete')
-        .description('Deactivate the did:btcr2 identifier permanently. This is irreversible.')
-        .requiredOption('-s, --source-document <json>', 'Current DID document as JSON string', parseJsonArg('--source-document'))
-        .requiredOption('--source-version-id <number>', 'Current version ID of the DID document')
-        .requiredOption('-m, --verification-method-id <id>', 'DID document verification method ID used to sign the deactivation')
-        .requiredOption('-b, --beacon-id <json>', 'Beacon ID as a JSON string', parseJsonArg('--beacon-id'))
-        .action(async (options) => {
-        const parsed = {
-            sourceDocument: options.sourceDocument,
-            patches: DEACTIVATION_PATCH,
-            sourceVersionId: Number(options.sourceVersionId),
-            verificationMethodId: options.verificationMethodId,
-            beaconId: options.beaconId,
-        };
-        const data = await api.btcr2.update(parsed);
-        const result = { action: 'deactivate', data };
-        console.log(formatResult(result, globals()));
-    });
-}
-/**
- * Returns a commander argParser that validates JSON.
- * Errors at parse time with a clear flag reference.
- */
-function parseJsonArg(flagName) {
-    return (value) => {
-        try {
-            return JSON.parse(value);
-        }
-        catch {
-            throw new CLIError(`Invalid JSON for ${flagName}. Must be a valid JSON string.`, 'INVALID_ARGUMENT_ERROR', { flagName, value });
-        }
-    };
-}
-//# sourceMappingURL=deactivate.js.map

package/dist/cjs/commands/deactivate.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"deactivate.js","sourceRoot":"","sources":["../../../src/commands/deactivate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,2EAA2E;AAC3E,MAAM,kBAAkB,GAAG,CAAC,EAAE,EAAE,EAAE,KAAc,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAEvF,MAAM,UAAU,yBAAyB,CACvC,OAAiB,EACjB,GAAqB,EACrB,OAA6B;IAE7B,OAAO;SACJ,OAAO,CAAC,YAAY,CAAC;SACrB,KAAK,CAAC,QAAQ,CAAC;SACf,WAAW,CAAC,wEAAwE,CAAC;SACrF,cAAc,CACb,8BAA8B,EAC9B,qCAAqC,EACrC,YAAY,CAAC,mBAAmB,CAAC,CAClC;SACA,cAAc,CACb,8BAA8B,EAC9B,wCAAwC,CACzC;SACA,cAAc,CACb,mCAAmC,EACnC,mEAAmE,CACpE;SACA,cAAc,CACb,wBAAwB,EACxB,4BAA4B,EAC5B,YAAY,CAAC,aAAa,CAAC,CAC5B;SACA,MAAM,CAAC,KAAK,EAAE,OAKd,EAAE,EAAE;QACH,MAAM,MAAM,GAAyB;YACnC,cAAc,EAAS,OAAO,CAAC,cAAwD;YACvF,OAAO,EAAgB,kBAAkB;YACzC,eAAe,EAAQ,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC;YACtD,oBAAoB,EAAG,OAAO,CAAC,oBAAoB;YACnD,QAAQ,EAAe,OAAO,CAAC,QAA4C;SAC5E,CAAC;QACF,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,YAAqB,EAAE,IAAI,EAAE,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,QAAgB;IACpC,OAAO,CAAC,KAAa,EAAW,EAAE;QAChC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,QAAQ,CAChB,oBAAoB,QAAQ,gCAAgC,EAC5D,wBAAwB,EACxB,EAAE,QAAQ,EAAE,KAAK,EAAE,CACpB,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/cjs/commands/index.js

@@ -1,5 +0,0 @@
-export { registerCreateCommand } from './create.js';
-export { registerResolveCommand } from './resolve.js';
-export { registerUpdateCommand } from './update.js';
-export { registerDeactivateCommand } from './deactivate.js';
-//# sourceMappingURL=index.js.map

package/dist/cjs/commands/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/cjs/commands/resolve.js

@@ -1,43 +0,0 @@
-import { Identifier } from '@did-btcr2/api';
-import { readFile } from 'node:fs/promises';
-import { CLIError } from '../error.js';
-import { formatResult } from '../output.js';
-export function registerResolveCommand(program, api, globals) {
-    program
-        .command('resolve')
-        .alias('read')
-        .description('Resolve the DID document of the identifier.')
-        .requiredOption('-i, --identifier <identifier>', 'did:btcr2 identifier')
-        .option('-r, --resolution-options <json>', 'JSON string containing resolution options')
-        .option('-p, --resolution-options-path <path>', 'Path to a JSON file containing resolution options')
-        .action(async (options) => {
-        const parsed = await validateResolveOptions(options);
-        const data = await api.resolveDid(parsed.identifier, parsed.options);
-        const result = { action: 'resolve', data };
-        console.log(formatResult(result, globals()));
-    });
-}
-async function validateResolveOptions(options) {
-    // Validate identifier format early
-    Identifier.decode(options.identifier);
-    let resolutionOptions = undefined;
-    if (options.resolutionOptions) {
-        try {
-            resolutionOptions = JSON.parse(options.resolutionOptions);
-        }
-        catch {
-            throw new CLIError('Invalid resolution options. Must be a valid JSON string.', 'INVALID_ARGUMENT_ERROR', options);
-        }
-    }
-    else if (options.resolutionOptionsPath) {
-        try {
-            const content = await readFile(options.resolutionOptionsPath, 'utf-8');
-            resolutionOptions = JSON.parse(content);
-        }
-        catch {
-            throw new CLIError('Invalid resolution options path. Must be a valid path to a JSON file.', 'INVALID_ARGUMENT_ERROR', options);
-        }
-    }
-    return { identifier: options.identifier, options: resolutionOptions };
-}
-//# sourceMappingURL=resolve.js.map

package/dist/cjs/commands/resolve.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../src/commands/resolve.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,MAAM,UAAU,sBAAsB,CACpC,OAAiB,EACjB,GAAqB,EACrB,OAA6B;IAE7B,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,KAAK,CAAC,MAAM,CAAC;SACb,WAAW,CAAC,6CAA6C,CAAC;SAC1D,cAAc,CAAC,+BAA+B,EAAE,sBAAsB,CAAC;SACvE,MAAM,CAAC,iCAAiC,EAAE,2CAA2C,CAAC;SACtF,MAAM,CAAC,sCAAsC,EAAE,mDAAmD,CAAC;SACnG,MAAM,CAAC,KAAK,EAAE,OAId,EAAE,EAAE;QACH,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,SAAkB,EAAE,IAAI,EAAE,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACP,CAAC;AAED,KAAK,UAAU,sBAAsB,CAAC,OAIrC;IACC,mCAAmC;IACnC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAEtC,IAAI,iBAAiB,GAAG,SAAS,CAAC;IAClC,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QAC5D,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,QAAQ,CAChB,0DAA0D,EAC1D,wBAAwB,EACxB,OAAO,CACR,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;YACvE,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,QAAQ,CAChB,uEAAuE,EACvE,wBAAwB,EACxB,OAAO,CACR,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC;AACxE,CAAC"}

package/dist/cjs/commands/update.js

@@ -1,39 +0,0 @@
-import { CLIError } from '../error.js';
-import { formatResult } from '../output.js';
-export function registerUpdateCommand(program, api, globals) {
-    program
-        .command('update')
-        .description('Update a did:btcr2 document.')
-        .requiredOption('-s, --source-document <json>', 'Source DID document as JSON string', parseJsonArg('--source-document'))
-        .requiredOption('--source-version-id <number>', 'Source version ID as a number')
-        .requiredOption('-p, --patches <json>', 'JSON Patch operations as a JSON string array', parseJsonArg('--patches'))
-        .requiredOption('-m, --verification-method-id <id>', 'DID document verification method ID')
-        .requiredOption('-b, --beacon-id <json>', 'Beacon ID as a JSON string', parseJsonArg('--beacon-id'))
-        .action(async (options) => {
-        const parsed = {
-            sourceDocument: options.sourceDocument,
-            patches: options.patches,
-            sourceVersionId: Number(options.sourceVersionId),
-            verificationMethodId: options.verificationMethodId,
-            beaconId: options.beaconId,
-        };
-        const data = await api.btcr2.update(parsed);
-        const result = { action: 'update', data };
-        console.log(formatResult(result, globals()));
-    });
-}
-/**
- * Returns a commander argParser that validates JSON.
- * Errors at parse time with a clear flag reference.
- */
-function parseJsonArg(flagName) {
-    return (value) => {
-        try {
-            return JSON.parse(value);
-        }
-        catch {
-            throw new CLIError(`Invalid JSON for ${flagName}. Must be a valid JSON string.`, 'INVALID_ARGUMENT_ERROR', { flagName, value });
-        }
-    };
-}
-//# sourceMappingURL=update.js.map

package/dist/cjs/commands/update.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/commands/update.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,MAAM,UAAU,qBAAqB,CACnC,OAAiB,EACjB,GAAqB,EACrB,OAA6B;IAE7B,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,8BAA8B,CAAC;SAC3C,cAAc,CACb,8BAA8B,EAC9B,oCAAoC,EACpC,YAAY,CAAC,mBAAmB,CAAC,CAClC;SACA,cAAc,CACb,8BAA8B,EAC9B,+BAA+B,CAChC;SACA,cAAc,CACb,sBAAsB,EACtB,8CAA8C,EAC9C,YAAY,CAAC,WAAW,CAAC,CAC1B;SACA,cAAc,CACb,mCAAmC,EACnC,qCAAqC,CACtC;SACA,cAAc,CACb,wBAAwB,EACxB,4BAA4B,EAC5B,YAAY,CAAC,aAAa,CAAC,CAC5B;SACA,MAAM,CAAC,KAAK,EAAE,OAMd,EAAE,EAAE;QACH,MAAM,MAAM,GAAyB;YACnC,cAAc,EAAS,OAAO,CAAC,cAAwD;YACvF,OAAO,EAAgB,OAAO,CAAC,OAA0C;YACzE,eAAe,EAAQ,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC;YACtD,oBAAoB,EAAG,OAAO,CAAC,oBAAoB;YACnD,QAAQ,EAAe,OAAO,CAAC,QAA4C;SAC5E,CAAC;QACF,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,QAAiB,EAAE,IAAI,EAAE,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,QAAgB;IACpC,OAAO,CAAC,KAAa,EAAW,EAAE;QAChC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,QAAQ,CAChB,oBAAoB,QAAQ,gCAAgC,EAC5D,wBAAwB,EACxB,EAAE,QAAQ,EAAE,KAAK,EAAE,CACpB,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/cjs/error.js

@@ -1,10 +0,0 @@
-import { DidMethodError } from '@did-btcr2/common';
-/**
- * Custom CLI Error class extending DidMethodError.
- */
-export class CLIError extends DidMethodError {
-    constructor(message, type = 'CLIError', data) {
-        super(message, { type, name: 'CLIError', data });
-    }
-}
-//# sourceMappingURL=error.js.map