@kukks/bitcoin-descriptors 3.2.2 → 3.2.3

package/dist/index.d.ts

@@ -12,6 +12,7 @@ export type { PsbtLike } from './psbt.js';
 export { networks } from './networks.js';
 export type { Network } from './networks.js';
 export { nobleECPair, scureBIP32 } from './adapters.js';
+export { ensureMiniscriptLoaded } from './miniscript.js';
 export declare const defaultFactory: {
     Output: {
         new ({ descriptor, index, checksumRequired, allowMiniscriptInP2SH, network, preimages, signersPubKeys }: {

package/dist/index.js

@@ -10,6 +10,9 @@ export { scriptExpressions };
 export { networks } from './networks.js';
 // Built-in adapters using @noble/curves and @scure/bip32
 export { nobleECPair, scureBIP32 } from './adapters.js';
+// Optional miniscript support — call before using miniscript descriptors
+// if you need to guarantee the library is loaded synchronously.
+export { ensureMiniscriptLoaded } from './miniscript.js';
 // Pre-built factory using built-in adapters (zero-config convenience)
 import { DescriptorsFactory } from './descriptors.js';
 export const defaultFactory = DescriptorsFactory();

package/dist/miniscript.d.ts

@@ -2,6 +2,11 @@ import { Network } from './networks.js';
 import type { ECPairAPI } from './types.js';
 import type { BIP32API } from './types.js';
 import type { PartialSig } from './types.js';
+/**
+ * Ensure the optional miniscript library has finished loading.
+ * Call before using any miniscript code path.
+ */
+export declare function ensureMiniscriptLoaded(): Promise<void>;
 import type { Preimage, TimeConstraints, ExpansionMap } from './types.js';
 /**
  * Expand a miniscript to a generalized form using variables instead of key

package/dist/miniscript.js

@@ -6,23 +6,27 @@ import { hash160 } from '@scure/btc-signer/utils.js';
 import { hex } from '@scure/base';
 import { parseKeyExpression } from './keyExpressions.js';
 import * as RE from './re.js';
-import { createRequire } from 'module';
 // Lazy-load @bitcoinerlab/miniscript (optional peer dependency).
+// Uses dynamic import() so it works in both Node and browser bundlers (Vite/Rollup).
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 let _miniscriptLib;
+// Kick off loading immediately but don't block — the result is awaited on first use.
+const _miniscriptPromise = import('@bitcoinerlab/miniscript').then(m => (_miniscriptLib = m), () => { } // not installed — will error at use time
+);
 function getMiniscriptLib() {
     if (!_miniscriptLib) {
-        try {
-            const require = createRequire(import.meta.url);
-            _miniscriptLib = require('@bitcoinerlab/miniscript');
-        }
-        catch {
-            throw new Error('@bitcoinerlab/miniscript is required for miniscript descriptors. ' +
-                'Install it: npm install @bitcoinerlab/miniscript');
-        }
+        throw new Error('@bitcoinerlab/miniscript is required for miniscript descriptors. ' +
+            'Install it: npm install @bitcoinerlab/miniscript');
     }
     return _miniscriptLib;
 }
+/**
+ * Ensure the optional miniscript library has finished loading.
+ * Call before using any miniscript code path.
+ */
+export async function ensureMiniscriptLoaded() {
+    await _miniscriptPromise;
+}
 /**
  * Expand a miniscript to a generalized form using variables instead of key
  * expressions. Variables will be of this form: @0, @1, ...

package/package.json

@@ -2,7 +2,7 @@
   "name": "@kukks/bitcoin-descriptors",
   "description": "This library parses and creates Bitcoin Miniscript Descriptors and generates Partially Signed Bitcoin Transactions (PSBTs). It provides PSBT finalizers and signers for single-signature, BIP32 and Hardware Wallets.",
   "homepage": "https://github.com/Kukks/descriptors",
-  "version": "3.2.2",
+  "version": "3.2.3",
   "author": "Jose-Luis Landabaso",
   "license": "MIT",
   "repository": {