@bigmi/core 0.5.2 → 0.5.4

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [0.5.4](https://github.com/lifinance/bigmi/compare/v0.5.3...v0.5.4) (2025-09-29)
+
+
+### Bug Fixes
+
+* **blockchair:** handle zero balance addresses edge case ([#35](https://github.com/lifinance/bigmi/issues/35)) ([a57c5fd](https://github.com/lifinance/bigmi/commit/a57c5fd49ec22df2dd6165725ce2750d81f3267e))
+
+### [0.5.3](https://github.com/lifinance/bigmi/compare/v0.5.2...v0.5.3) (2025-09-22)
+
 ### [0.5.2](https://github.com/lifinance/bigmi/compare/v0.5.1...v0.5.2) (2025-08-28)
 
 

package/dist/cjs/transports/blockchair/__mocks__/getBalance/zeroBalance.json

@@ -0,0 +1,29 @@
+{
+    "data": [],
+    "context": {
+        "code": 200,
+        "source": "A",
+        "results": 0,
+        "state": 916465,
+        "market_price_usd": 109158,
+        "cache": {
+            "live": true,
+            "duration": 120,
+            "since": "2025-09-26 10:32:00",
+            "until": "2025-09-26 10:34:00",
+            "time": null
+        },
+        "api": {
+            "version": "2.0.95-ie",
+            "last_major_update": "2022-11-07 02:00:00",
+            "next_major_update": "2023-11-12 02:00:00",
+            "documentation": "https://blockchair.com/api/docs",
+            "notice": "Try out our new API v.3: https://3xpl.com/data"
+        },
+        "servers": "API4,BTC5",
+        "time": 1.4955880641937256,
+        "render_time": 0.014816761016845703,
+        "full_time": 1.5104048252105713,
+        "request_cost": 1.001
+    }
+}

package/dist/cjs/transports/blockchair/getBalance.js.map

@@ -1 +1 @@
-{"version":3,"file":"getBalance.js","sourceRoot":"","sources":["../../../../src/transports/blockchair/getBalance.ts"],"names":[],"mappings":";;;AAAA,gDAAkD;AAClD,+CAAkD;AAO3C,MAAM,UAAU,GAAmC,KAAK,EAC7D,MAAM,EACN,EAAE,OAAO,EAAE,MAAM,EAAE,EACnB,EAAE,OAAO,EAAE,EACX,EAAE;IACF,MAAM,MAAM,GAAG,IAAA,sBAAa,EAAC,GAAG,OAAO,qBAAqB,EAAE;QAC5D,GAAG,EAAE,MAAM;QACX,SAAS,EAAE,OAAO;KACnB,CAAC,CAAA;IACF,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC;QACrC,GAAG,EAAE,MAAM;QACX,YAAY,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;KAChC,CAAC,CAAgE,CAAA;IAClE,IACE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,SAAS;QACpC,QAAQ,CAAC,OAAO,CAAC,KAAK;QACtB,QAAQ,CAAC,OAAO,EAAE,IAAI,KAAK,GAAG,EAC9B,CAAC;QACD,OAAO;YACL,KAAK,EAAE;gBACL,IAAI,EACF,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,GAAG;oBAC3B,CAAC,CAAC,qBAAY,CAAC,aAAa;oBAC5B,CAAC,CAAC,qBAAY,CAAC,UAAU;gBAC7B,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,KAAK;aACjC;SACF,CAAA;IACH,CAAC;IACD,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;KACvC,CAAA;AACH,CAAC,CAAA;AA/BY,QAAA,UAAU,cA+BtB"}
+{"version":3,"file":"getBalance.js","sourceRoot":"","sources":["../../../../src/transports/blockchair/getBalance.ts"],"names":[],"mappings":";;;AAAA,gDAAkD;AAClD,+CAAkD;AAO3C,MAAM,UAAU,GAAmC,KAAK,EAC7D,MAAM,EACN,EAAE,OAAO,EAAE,MAAM,EAAE,EACnB,EAAE,OAAO,EAAE,EACX,EAAE;IACF,MAAM,MAAM,GAAG,IAAA,sBAAa,EAAC,GAAG,OAAO,qBAAqB,EAAE;QAC5D,GAAG,EAAE,MAAM;QACX,SAAS,EAAE,OAAO;KACnB,CAAC,CAAA;IACF,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC;QACrC,GAAG,EAAE,MAAM;QACX,YAAY,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;KAChC,CAAC,CAAgE,CAAA;IAElE,IACE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,SAAS;QACpC,QAAQ,CAAC,OAAO,CAAC,KAAK;QACtB,QAAQ,CAAC,OAAO,EAAE,IAAI,KAAK,GAAG,EAC9B,CAAC;QACD,OAAO;YACL,KAAK,EAAE;gBACL,IAAI,EACF,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,GAAG;oBAC3B,CAAC,CAAC,qBAAY,CAAC,aAAa;oBAC5B,CAAC,CAAC,qBAAY,CAAC,UAAU;gBAC7B,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,KAAK;aACjC;SACF,CAAA;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;KACvC,CAAA;AACH,CAAC,CAAA;AAjCY,QAAA,UAAU,cAiCtB"}

package/dist/cjs/transports/blockchair/getUTXOs.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getUTXOs = void 0;
+const base_js_1 = require("../../errors/base.js");
 const request_js_1 = require("../../errors/request.js");
 const rpc_js_1 = require("../../errors/rpc.js");
 const utxo_js_1 = require("../../errors/utxo.js");
@@ -67,7 +68,17 @@ const getUTXOs = async (client, { baseUrl, apiKey }, { address, minValue }) => {
         }
     }
     if (minValue) {
-        const { result: balance } = await (0, getBalance_js_1.getBalance)(client, { baseUrl, apiKey }, { address });
+        const { error, result: balance } = await (0, getBalance_js_1.getBalance)(client, { baseUrl, apiKey }, { address });
+        if (error) {
+            throw new base_js_1.BaseError('Error fetching balance', {
+                cause: error,
+            });
+        }
+        if (balance === undefined) {
+            throw new base_js_1.BaseError('Balance is undefined', {
+                cause: new Error('Unable to determine balance'),
+            });
+        }
         if (minValue > Number(balance)) {
             throw new utxo_js_1.InsufficientUTXOBalanceError({
                 minValue,

package/dist/cjs/transports/blockchair/getUTXOs.js.map

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

package/dist/cjs/version.d.ts

@@ -1,2 +1,2 @@
 export declare const name = "@bigmi/core";
-export declare const version = "0.5.2";
+export declare const version = "0.5.4";

package/dist/cjs/version.js

@@ -2,5 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.version = exports.name = void 0;
 exports.name = '@bigmi/core';
-exports.version = '0.5.2';
+exports.version = '0.5.4';
 //# sourceMappingURL=version.js.map

package/dist/esm/transports/blockchair/__mocks__/getBalance/zeroBalance.json

@@ -0,0 +1,29 @@
+{
+    "data": [],
+    "context": {
+        "code": 200,
+        "source": "A",
+        "results": 0,
+        "state": 916465,
+        "market_price_usd": 109158,
+        "cache": {
+            "live": true,
+            "duration": 120,
+            "since": "2025-09-26 10:32:00",
+            "until": "2025-09-26 10:34:00",
+            "time": null
+        },
+        "api": {
+            "version": "2.0.95-ie",
+            "last_major_update": "2022-11-07 02:00:00",
+            "next_major_update": "2023-11-12 02:00:00",
+            "documentation": "https://blockchair.com/api/docs",
+            "notice": "Try out our new API v.3: https://3xpl.com/data"
+        },
+        "servers": "API4,BTC5",
+        "time": 1.4955880641937256,
+        "render_time": 0.014816761016845703,
+        "full_time": 1.5104048252105713,
+        "request_cost": 1.001
+    }
+}

package/dist/esm/transports/blockchair/getBalance.js.map

@@ -1 +1 @@
-{"version":3,"file":"getBalance.js","sourceRoot":"","sources":["../../../../src/transports/blockchair/getBalance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAOlD,MAAM,CAAC,MAAM,UAAU,GAAmC,KAAK,EAC7D,MAAM,EACN,EAAE,OAAO,EAAE,MAAM,EAAE,EACnB,EAAE,OAAO,EAAE,EACX,EAAE;IACF,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,OAAO,qBAAqB,EAAE;QAC5D,GAAG,EAAE,MAAM;QACX,SAAS,EAAE,OAAO;KACnB,CAAC,CAAA;IACF,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC;QACrC,GAAG,EAAE,MAAM;QACX,YAAY,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;KAChC,CAAC,CAAgE,CAAA;IAClE,IACE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,SAAS;QACpC,QAAQ,CAAC,OAAO,CAAC,KAAK;QACtB,QAAQ,CAAC,OAAO,EAAE,IAAI,KAAK,GAAG,EAC9B,CAAC;QACD,OAAO;YACL,KAAK,EAAE;gBACL,IAAI,EACF,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,GAAG;oBAC3B,CAAC,CAAC,YAAY,CAAC,aAAa;oBAC5B,CAAC,CAAC,YAAY,CAAC,UAAU;gBAC7B,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,KAAK;aACjC;SACF,CAAA;IACH,CAAC;IACD,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;KACvC,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"getBalance.js","sourceRoot":"","sources":["../../../../src/transports/blockchair/getBalance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAOlD,MAAM,CAAC,MAAM,UAAU,GAAmC,KAAK,EAC7D,MAAM,EACN,EAAE,OAAO,EAAE,MAAM,EAAE,EACnB,EAAE,OAAO,EAAE,EACX,EAAE;IACF,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,OAAO,qBAAqB,EAAE;QAC5D,GAAG,EAAE,MAAM;QACX,SAAS,EAAE,OAAO;KACnB,CAAC,CAAA;IACF,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC;QACrC,GAAG,EAAE,MAAM;QACX,YAAY,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;KAChC,CAAC,CAAgE,CAAA;IAElE,IACE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,SAAS;QACpC,QAAQ,CAAC,OAAO,CAAC,KAAK;QACtB,QAAQ,CAAC,OAAO,EAAE,IAAI,KAAK,GAAG,EAC9B,CAAC;QACD,OAAO;YACL,KAAK,EAAE;gBACL,IAAI,EACF,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,GAAG;oBAC3B,CAAC,CAAC,YAAY,CAAC,aAAa;oBAC5B,CAAC,CAAC,YAAY,CAAC,UAAU;gBAC7B,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,KAAK;aACjC;SACF,CAAA;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;KACvC,CAAA;AACH,CAAC,CAAA"}

package/dist/esm/transports/blockchair/getUTXOs.js

@@ -1,3 +1,4 @@
+import { BaseError } from '../../errors/base.js';
 import { RpcRequestError } from '../../errors/request.js';
 import { RpcErrorCode } from '../../errors/rpc.js';
 import { InsufficientUTXOBalanceError } from '../../errors/utxo.js';
@@ -64,7 +65,17 @@ export const getUTXOs = async (client, { baseUrl, apiKey }, { address, minValue
         }
     }
     if (minValue) {
-        const { result: balance } = await getBalance(client, { baseUrl, apiKey }, { address });
+        const { error, result: balance } = await getBalance(client, { baseUrl, apiKey }, { address });
+        if (error) {
+            throw new BaseError('Error fetching balance', {
+                cause: error,
+            });
+        }
+        if (balance === undefined) {
+            throw new BaseError('Balance is undefined', {
+                cause: new Error('Unable to determine balance'),
+            });
+        }
         if (minValue > Number(balance)) {
             throw new InsufficientUTXOBalanceError({
                 minValue,

package/dist/esm/transports/blockchair/getUTXOs.js.map

@@ -1 +1 @@
-{"version":3,"file":"getUTXOs.js","sourceRoot":"","sources":["../../../../src/transports/blockchair/getUTXOs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"getUTXOs.js","sourceRoot":"","sources":["../../../../src/transports/blockchair/getUTXOs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAA;AAGnE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAOlD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C,MAAM,yBAAyB,GAC7B,CAAC,SAAiB,EAAE,EAAE,CACtB,CAAC,IAAoB,EAAQ,EAAE,CAAC,CAAC;IAC/B,WAAW,EAAE,IAAI,CAAC,QAAQ;IAC1B,SAAS;IACT,IAAI,EAAE,IAAI,CAAC,gBAAgB;IAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;IACjB,IAAI,EAAE,IAAI,CAAC,KAAK;CACjB,CAAC,CAAA;AAEJ,MAAM,aAAa,GAAG,SAAS,CAAA;AAE/B,MAAM,CAAC,MAAM,QAAQ,GAAiC,KAAK,EACzD,MAAM,EACN,EAAE,OAAO,EAAE,MAAM,EAAE,EACnB,EAAE,OAAO,EAAE,QAAQ,EAAE,EACrB,EAAE;IACF,KAAK,SAAS,CAAC,CAAC,UAAU;QACxB,IAAI,MAAM,GAAG,CAAC,CAAA;QACd,IAAI,OAAO,GAAG,IAAI,CAAA;QAElB,OAAO,OAAO,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,aAAa,CAC1B,GAAG,OAAO,yBAAyB,OAAO,EAAE,EAC5C;gBACE,GAAG,EAAE,MAAM;gBACX,MAAM,EAAE,KAAK,MAAM,EAAE;gBACrB,KAAK,EAAE,aAAa;aACrB,CACF,CAAA;YACD,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC;gBACrC,GAAG,EAAE,MAAM;gBACX,YAAY,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;aAChC,CAAC,CAAsE,CAAA;YAExE,IAAI,QAAQ,CAAC,OAAO,EAAE,IAAI,KAAK,GAAG,IAAI,QAAQ,CAAC,OAAO,EAAE,IAAI,KAAK,GAAG,EAAE,CAAC;gBACrE,MAAM,IAAI,eAAe,CAAC;oBACxB,GAAG,EAAE,MAAM;oBACX,IAAI,EAAE;wBACJ,MAAM,EAAE,YAAY;wBACpB,MAAM,EAAE;4BACN,OAAO;4BACP,QAAQ;yBACT;qBACF;oBACD,KAAK,EAAE;wBACL,IAAI,EACF,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,GAAG;4BAC3B,CAAC,CAAC,YAAY,CAAC,aAAa;4BAC5B,CAAC,CAAC,YAAY,CAAC,UAAU;wBAC7B,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,IAAI,sBAAsB;qBAC1D;iBACF,CAAC,CAAA;YACJ,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtD,OAAO,GAAG,KAAK,CAAA;gBACf,SAAQ;YACV,CAAC;YAED,MAAM,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAA;YAClC,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAAA;YACvE,IAAI,KAAK,IAAI,SAAS,EAAE,CAAC;gBACvB,MAAM,CAAC,EAAE,SAAS,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;qBAChC,KAAK,CAAC,GAAG,CAAC;qBACV,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;gBAC5B,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;gBACxC,MAAM,IAAI,SAAS,CAAA;YACrB,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,KAAK,CAAA;gBACf,MAAM,IAAI,CAAC,CAAA;YACb,CAAC;YAED,MAAM,QAAQ,CAAC,IAAI,CAAA;QACrB,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,UAAU,CACjD,MAAM,EACN,EAAE,OAAO,EAAE,MAAM,EAAE,EACnB,EAAE,OAAO,EAAE,CACZ,CAAA;QAED,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,IAAI,SAAS,CAAC,wBAAwB,EAAE;gBAC5C,KAAK,EAAE,KAAK;aACb,CAAC,CAAA;QACJ,CAAC;QAED,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,IAAI,SAAS,CAAC,sBAAsB,EAAE;gBAC1C,KAAK,EAAE,IAAI,KAAK,CAAC,6BAA6B,CAAC;aAChD,CAAC,CAAA;QACJ,CAAC;QAED,IAAI,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,4BAA4B,CAAC;gBACrC,QAAQ;gBACR,OAAO;gBACP,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC;aACzB,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAW,EAAE,CAAA;IACxB,IAAI,UAAU,GAAG,CAAC,CAAA;IAElB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,UAAU,EAAE,EAAE,CAAC;QACvC,MAAM,gBAAgB,GAAG,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,UAAU,CAAA;QAC5D,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAC9B,yBAAyB,CAAC,gBAAgB,CAAC,CAC5C,CAAA;QACD,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAA;QAExB,IAAI,QAAQ,EAAE,CAAC;YACb,UAAU,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;YAClE,IAAI,UAAU,IAAI,QAAQ,EAAE,CAAC;gBAC3B,MAAK;YACP,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;AAC1B,CAAC,CAAA"}

package/dist/esm/version.d.ts

@@ -1,2 +1,2 @@
 export declare const name = "@bigmi/core";
-export declare const version = "0.5.2";
+export declare const version = "0.5.4";

package/dist/esm/version.js

@@ -1,3 +1,3 @@
 export const name = '@bigmi/core';
-export const version = '0.5.2';
+export const version = '0.5.4';
 //# sourceMappingURL=version.js.map

package/dist/types/transports/blockchair/getBalance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getBalance.d.ts","sourceRoot":"","sources":["../../../../src/transports/blockchair/getBalance.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAMnD,eAAO,MAAM,UAAU,EAAE,gBAAgB,CAAC,YAAY,CA+BrD,CAAA"}
+{"version":3,"file":"getBalance.d.ts","sourceRoot":"","sources":["../../../../src/transports/blockchair/getBalance.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAMnD,eAAO,MAAM,UAAU,EAAE,gBAAgB,CAAC,YAAY,CAiCrD,CAAA"}

package/dist/types/transports/blockchair/getUTXOs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getUTXOs.d.ts","sourceRoot":"","sources":["../../../../src/transports/blockchair/getUTXOs.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAoBnD,eAAO,MAAM,QAAQ,EAAE,gBAAgB,CAAC,UAAU,CAkGjD,CAAA"}
+{"version":3,"file":"getUTXOs.d.ts","sourceRoot":"","sources":["../../../../src/transports/blockchair/getUTXOs.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAoBnD,eAAO,MAAM,QAAQ,EAAE,gBAAgB,CAAC,UAAU,CA+GjD,CAAA"}

package/dist/types/version.d.ts

@@ -1,3 +1,3 @@
 export declare const name = "@bigmi/core";
-export declare const version = "0.5.2";
+export declare const version = "0.5.4";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bigmi/core",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "description": "TypeScript library for Bitcoin apps.",
   "type": "module",
   "main": "./dist/esm/index.js",

package/package.json.tmp

@@ -1,6 +1,6 @@
 {
   "name": "@bigmi/core",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "description": "TypeScript library for Bitcoin apps.",
   "type": "module",
   "main": "./src/index.ts",

package/src/transports/blockchair/__mocks__/getBalance/zeroBalance.json

@@ -0,0 +1,29 @@
+{
+  "data": [],
+  "context": {
+    "code": 200,
+    "source": "A",
+    "results": 0,
+    "state": 916465,
+    "market_price_usd": 109158,
+    "cache": {
+      "live": true,
+      "duration": 120,
+      "since": "2025-09-26 10:32:00",
+      "until": "2025-09-26 10:34:00",
+      "time": null
+    },
+    "api": {
+      "version": "2.0.95-ie",
+      "last_major_update": "2022-11-07 02:00:00",
+      "next_major_update": "2023-11-12 02:00:00",
+      "documentation": "https://blockchair.com/api/docs",
+      "notice": "Try out our new API v.3: https://3xpl.com/data"
+    },
+    "servers": "API4,BTC5",
+    "time": 1.4955880641937256,
+    "render_time": 0.014816761016845703,
+    "full_time": 1.5104048252105713,
+    "request_cost": 1.001
+  }
+}

package/src/transports/blockchair/blockchair.spec.ts

@@ -15,6 +15,7 @@ import {
 import type { UTXOSchema } from '../types.js'
 import getInvalidBalanceReponse from './__mocks__/getBalance/invalidAddress.json'
 import getBalanceReponse from './__mocks__/getBalance/valid.json'
+import getZeroBalanceReponse from './__mocks__/getBalance/zeroBalance.json'
 import getTransactionFeeInvalidResponse from './__mocks__/getTransactionFee/invalid.json'
 import getTransactionFeeValidResponse from './__mocks__/getTransactionFee/valid.json'
 import getUTXOsInvalidResponse from './__mocks__/getUTXOs/invalidAddress.json'
@@ -74,6 +75,21 @@ describe('Blockchair Transport', () => {
     })
   })
 
+  it('should throw error for zero balance address', async () => {
+    if (USE_MOCK) {
+      vi.spyOn(global, 'fetch').mockResolvedValue(
+        createMockResponse(
+          getZeroBalanceReponse as BlockchairAddressBalanceData
+        )
+      )
+    }
+
+    const zeroBalanceAddress = '12LRT14SgNFFQ3hMRThAyXNao24BBy5cyU'
+    await expect(
+      getBalance(publicClient, { address: zeroBalanceAddress })
+    ).rejects.toThrow()
+  })
+
   describe('getUTXOs', () => {
     it('should return utxos with correct structure', async () => {
       if (USE_MOCK) {

package/src/transports/blockchair/getBalance.ts

@@ -19,6 +19,7 @@ export const getBalance: RpcMethodHandler<'getBalance'> = async (
     url: apiUrl,
     fetchOptions: { method: 'GET' },
   })) as unknown as BlockchairResponse<BlockchairAddressBalanceData>
+
   if (
     response.data[address] === undefined ||
     response.context.error ||
@@ -34,6 +35,7 @@ export const getBalance: RpcMethodHandler<'getBalance'> = async (
       },
     }
   }
+
   return {
     result: BigInt(response.data[address]),
   }

package/src/transports/blockchair/getUTXOs.ts

@@ -1,3 +1,4 @@
+import { BaseError } from '../../errors/base.js'
 import { RpcRequestError } from '../../errors/request.js'
 import { RpcErrorCode } from '../../errors/rpc.js'
 import { InsufficientUTXOBalanceError } from '../../errors/utxo.js'
@@ -90,11 +91,24 @@ export const getUTXOs: RpcMethodHandler<'getUTXOs'> = async (
   }
 
   if (minValue) {
-    const { result: balance } = await getBalance(
+    const { error, result: balance } = await getBalance(
       client,
       { baseUrl, apiKey },
       { address }
     )
+
+    if (error) {
+      throw new BaseError('Error fetching balance', {
+        cause: error,
+      })
+    }
+
+    if (balance === undefined) {
+      throw new BaseError('Balance is undefined', {
+        cause: new Error('Unable to determine balance'),
+      })
+    }
+
     if (minValue > Number(balance)) {
       throw new InsufficientUTXOBalanceError({
         minValue,

package/src/transports/fallback.spec.ts

@@ -5,6 +5,7 @@ import { AllTransportsFailedError } from '../errors/transport.js'
 import { InsufficientUTXOBalanceError } from '../errors/utxo.js'
 import { createClient, rpcSchema } from '../factories/createClient.js'
 import { createMockResponse } from '../test/utils.js'
+import blockchairZeroBalanceResponse from './blockchair/__mocks__/getBalance/zeroBalance.json'
 import blockchairLimitedResponse from './blockchair/__mocks__/getUTXOs/rateLimited.json'
 import blockchairValidResponse from './blockchair/__mocks__/getUTXOs/valid.json'
 import { blockchair } from './blockchair/blockchair.js'
@@ -27,6 +28,15 @@ const publicClient = createClient({
   ]),
 })
 
+const blockchairFirstClient = createClient({
+  chain: bitcoin,
+  rpcSchema: rpcSchema<UTXOSchema>(),
+  transport: fallback([
+    blockchair({ apiKey }),
+    blockcypher({ apiKey: blockCypherKey }),
+  ]),
+})
+
 describe('Fallback Transport', () => {
   beforeEach(() => {
     vi.restoreAllMocks()
@@ -58,6 +68,21 @@ describe('Fallback Transport', () => {
       expect(utxos.length).toBeGreaterThan(0)
     })
 
+    it('blockchair first client should fallback to blockcypher when fetching with a zero balance address', async () => {
+      vi.spyOn(global, 'fetch').mockImplementation((request) => {
+        const url = new URL(request.toString())
+        if (url.hostname.includes('blockcypher')) {
+          return Promise.resolve(createMockResponse(blockcypherValidResponse))
+        }
+
+        return Promise.resolve(
+          createMockResponse(blockchairZeroBalanceResponse)
+        )
+      })
+      const utxos = await getUTXOs(blockchairFirstClient, { address })
+      expect(utxos.length).toBeGreaterThan(0)
+    })
+
     it('should throw error when both transports fail', async () => {
       vi.spyOn(global, 'fetch').mockImplementation((request) => {
         const url = new URL(request.toString())

package/src/version.ts

@@ -1,2 +1,2 @@
 export const name = '@bigmi/core'
-export const version = '0.5.2'
+export const version = '0.5.4'

package/dist/cjs/types/actions.d.ts

@@ -1,17 +0,0 @@
-import type { SendUTXOTransactionParameters, SendUTXOTransactionReturnType } from '../actions/sendUTXOTransaction.js';
-import type { WaitForTransactionReceiptParameters } from '../actions/waitForTransaction.js';
-import type { SignPsbtParameters, SignPsbtReturnType } from '../transports/types.js';
-import type { UTXOTransaction } from './transaction.js';
-export type WaitForTransactionReceiptReturnType = UTXOTransaction;
-export type WithRetryParameters = {
-    delay?: ((config: {
-        count: number;
-        error: Error;
-    }) => number) | number | undefined;
-    retryCount?: number | undefined;
-};
-export type WalletActions = {
-    sendUTXOTransaction: (args: SendUTXOTransactionParameters) => Promise<SendUTXOTransactionReturnType>;
-    signPbst: (args: SignPsbtParameters) => Promise<SignPsbtReturnType>;
-    waitForTransactionReceipt: (args: WaitForTransactionReceiptParameters) => Promise<WaitForTransactionReceiptReturnType>;
-};

package/dist/cjs/types/actions.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=actions.js.map

package/dist/cjs/types/actions.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../../src/types/actions.ts"],"names":[],"mappings":""}

package/dist/cjs/types/storage.d.ts

@@ -1,22 +0,0 @@
-import type { Compute } from './utils.js';
-export type StorageItemMap = {
-    recentConnectorId: string;
-    state: any;
-};
-export type Storage<itemMap extends Record<string, unknown> = Record<string, unknown>, storageItemMap extends StorageItemMap = StorageItemMap & itemMap> = {
-    key: string;
-    getItem<key extends keyof storageItemMap, value extends storageItemMap[key], defaultValue extends value | null | undefined>(key: key, defaultValue?: defaultValue | undefined): (defaultValue extends null ? value | null : value) | Promise<defaultValue extends null ? value | null : value>;
-    setItem<key extends keyof storageItemMap, value extends storageItemMap[key] | null>(key: key, value: value): void | Promise<void>;
-    removeItem(key: keyof storageItemMap): void | Promise<void>;
-};
-export type BaseStorage = {
-    getItem(key: string): string | null | undefined | Promise<string | null | undefined>;
-    setItem(key: string, value: string): void | Promise<void>;
-    removeItem(key: string): void | Promise<void>;
-};
-export type CreateStorageParameters = {
-    deserialize?: (<type>(value: string) => type | unknown) | undefined;
-    key?: string | undefined;
-    serialize?: (<type>(value: type | any) => string) | undefined;
-    storage?: Compute<BaseStorage> | undefined;
-};

package/dist/cjs/types/storage.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=storage.js.map

package/dist/cjs/types/storage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/types/storage.ts"],"names":[],"mappings":""}

package/dist/esm/types/actions.d.ts

@@ -1,20 +0,0 @@
-import type { SendUTXOTransactionParameters, SendUTXOTransactionReturnType } from '../actions/sendUTXOTransaction.js';
-import type { WaitForTransactionReceiptParameters } from '../actions/waitForTransaction.js';
-import type { SignPsbtParameters, SignPsbtReturnType } from '../transports/types.js';
-import type { UTXOTransaction } from './transaction.js';
-export type WaitForTransactionReceiptReturnType = UTXOTransaction;
-export type WithRetryParameters = {
-    delay?: ((config: {
-        count: number;
-        error: Error;
-    }) => number) | number | undefined;
-    retryCount?: number | undefined;
-};
-export type WalletActions = {
-    /**
-     * Creates, signs, and sends a new transaction to the network.
-     */
-    sendUTXOTransaction: (args: SendUTXOTransactionParameters) => Promise<SendUTXOTransactionReturnType>;
-    signPbst: (args: SignPsbtParameters) => Promise<SignPsbtReturnType>;
-    waitForTransactionReceipt: (args: WaitForTransactionReceiptParameters) => Promise<WaitForTransactionReceiptReturnType>;
-};

package/dist/esm/types/actions.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=actions.js.map

package/dist/esm/types/actions.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../../src/types/actions.ts"],"names":[],"mappings":""}

package/dist/esm/types/storage.d.ts

@@ -1,22 +0,0 @@
-import type { Compute } from './utils.js';
-export type StorageItemMap = {
-    recentConnectorId: string;
-    state: any;
-};
-export type Storage<itemMap extends Record<string, unknown> = Record<string, unknown>, storageItemMap extends StorageItemMap = StorageItemMap & itemMap> = {
-    key: string;
-    getItem<key extends keyof storageItemMap, value extends storageItemMap[key], defaultValue extends value | null | undefined>(key: key, defaultValue?: defaultValue | undefined): (defaultValue extends null ? value | null : value) | Promise<defaultValue extends null ? value | null : value>;
-    setItem<key extends keyof storageItemMap, value extends storageItemMap[key] | null>(key: key, value: value): void | Promise<void>;
-    removeItem(key: keyof storageItemMap): void | Promise<void>;
-};
-export type BaseStorage = {
-    getItem(key: string): string | null | undefined | Promise<string | null | undefined>;
-    setItem(key: string, value: string): void | Promise<void>;
-    removeItem(key: string): void | Promise<void>;
-};
-export type CreateStorageParameters = {
-    deserialize?: (<type>(value: string) => type | unknown) | undefined;
-    key?: string | undefined;
-    serialize?: (<type>(value: type | any) => string) | undefined;
-    storage?: Compute<BaseStorage> | undefined;
-};

package/dist/esm/types/storage.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=storage.js.map

package/dist/esm/types/storage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/types/storage.ts"],"names":[],"mappings":""}

package/dist/types/types/actions.d.ts

@@ -1,21 +0,0 @@
-import type { SendUTXOTransactionParameters, SendUTXOTransactionReturnType } from '../actions/sendUTXOTransaction.js';
-import type { WaitForTransactionReceiptParameters } from '../actions/waitForTransaction.js';
-import type { SignPsbtParameters, SignPsbtReturnType } from '../transports/types.js';
-import type { UTXOTransaction } from './transaction.js';
-export type WaitForTransactionReceiptReturnType = UTXOTransaction;
-export type WithRetryParameters = {
-    delay?: ((config: {
-        count: number;
-        error: Error;
-    }) => number) | number | undefined;
-    retryCount?: number | undefined;
-};
-export type WalletActions = {
-    /**
-     * Creates, signs, and sends a new transaction to the network.
-     */
-    sendUTXOTransaction: (args: SendUTXOTransactionParameters) => Promise<SendUTXOTransactionReturnType>;
-    signPbst: (args: SignPsbtParameters) => Promise<SignPsbtReturnType>;
-    waitForTransactionReceipt: (args: WaitForTransactionReceiptParameters) => Promise<WaitForTransactionReceiptReturnType>;
-};
-//# sourceMappingURL=actions.d.ts.map

package/dist/types/types/actions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/types/actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC7B,6BAA6B,EAC9B,MAAM,mCAAmC,CAAA;AAC1C,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,kCAAkC,CAAA;AAC3F,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAEvD,MAAM,MAAM,mCAAmC,GAAG,eAAe,CAAA;AAEjE,MAAM,MAAM,mBAAmB,GAAG;IAEhC,KAAK,CAAC,EACF,CAAC,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,KAAK,MAAM,CAAC,GACrD,MAAM,GACN,SAAS,CAAA;IAEb,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,mBAAmB,EAAE,CACnB,IAAI,EAAE,6BAA6B,KAChC,OAAO,CAAC,6BAA6B,CAAC,CAAA;IAE3C,QAAQ,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAEnE,yBAAyB,EAAE,CACzB,IAAI,EAAE,mCAAmC,KACtC,OAAO,CAAC,mCAAmC,CAAC,CAAA;CAClD,CAAA"}

package/dist/types/types/storage.d.ts

@@ -1,23 +0,0 @@
-import type { Compute } from './utils.js';
-export type StorageItemMap = {
-    recentConnectorId: string;
-    state: any;
-};
-export type Storage<itemMap extends Record<string, unknown> = Record<string, unknown>, storageItemMap extends StorageItemMap = StorageItemMap & itemMap> = {
-    key: string;
-    getItem<key extends keyof storageItemMap, value extends storageItemMap[key], defaultValue extends value | null | undefined>(key: key, defaultValue?: defaultValue | undefined): (defaultValue extends null ? value | null : value) | Promise<defaultValue extends null ? value | null : value>;
-    setItem<key extends keyof storageItemMap, value extends storageItemMap[key] | null>(key: key, value: value): void | Promise<void>;
-    removeItem(key: keyof storageItemMap): void | Promise<void>;
-};
-export type BaseStorage = {
-    getItem(key: string): string | null | undefined | Promise<string | null | undefined>;
-    setItem(key: string, value: string): void | Promise<void>;
-    removeItem(key: string): void | Promise<void>;
-};
-export type CreateStorageParameters = {
-    deserialize?: (<type>(value: string) => type | unknown) | undefined;
-    key?: string | undefined;
-    serialize?: (<type>(value: type | any) => string) | undefined;
-    storage?: Compute<BaseStorage> | undefined;
-};
-//# sourceMappingURL=storage.d.ts.map

package/dist/types/types/storage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/types/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEzC,MAAM,MAAM,cAAc,GAAG;IAC3B,iBAAiB,EAAE,MAAM,CAAA;IACzB,KAAK,EAAE,GAAG,CAAA;CACX,CAAA;AAED,MAAM,MAAM,OAAO,CACjB,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAEjE,cAAc,SAAS,cAAc,GAAG,cAAc,GAAG,OAAO,IAC9D;IACF,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CACL,GAAG,SAAS,MAAM,cAAc,EAChC,KAAK,SAAS,cAAc,CAAC,GAAG,CAAC,EACjC,YAAY,SAAS,KAAK,GAAG,IAAI,GAAG,SAAS,EAE7C,GAAG,EAAE,GAAG,EACR,YAAY,CAAC,EAAE,YAAY,GAAG,SAAS,GAErC,CAAC,YAAY,SAAS,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC,GAClD,OAAO,CAAC,YAAY,SAAS,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC,CAAA;IAC7D,OAAO,CACL,GAAG,SAAS,MAAM,cAAc,EAChC,KAAK,SAAS,cAAc,CAAC,GAAG,CAAC,GAAG,IAAI,EACxC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/C,UAAU,CAAC,GAAG,EAAE,MAAM,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5D,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,CACL,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;IACjE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9C,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,WAAW,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,GAAG,SAAS,CAAA;IACnE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACxB,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,GAAG,KAAK,MAAM,CAAC,GAAG,SAAS,CAAA;IAC7D,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,SAAS,CAAA;CAC3C,CAAA"}

package/src/types/actions.ts

@@ -1,37 +0,0 @@
-import type {
-  SendUTXOTransactionParameters,
-  SendUTXOTransactionReturnType,
-} from '../actions/sendUTXOTransaction.js'
-import type { WaitForTransactionReceiptParameters } from '../actions/waitForTransaction.js'
-import type {
-  SignPsbtParameters,
-  SignPsbtReturnType,
-} from '../transports/types.js'
-import type { UTXOTransaction } from './transaction.js'
-
-export type WaitForTransactionReceiptReturnType = UTXOTransaction
-
-export type WithRetryParameters = {
-  // The delay (in ms) between retries.
-  delay?:
-    | ((config: { count: number; error: Error }) => number)
-    | number
-    | undefined
-  // The max number of times to retry.
-  retryCount?: number | undefined
-}
-
-export type WalletActions = {
-  /**
-   * Creates, signs, and sends a new transaction to the network.
-   */
-  sendUTXOTransaction: (
-    args: SendUTXOTransactionParameters
-  ) => Promise<SendUTXOTransactionReturnType>
-
-  signPbst: (args: SignPsbtParameters) => Promise<SignPsbtReturnType>
-
-  waitForTransactionReceipt: (
-    args: WaitForTransactionReceiptParameters
-  ) => Promise<WaitForTransactionReceiptReturnType>
-}

package/src/types/storage.ts

@@ -1,44 +0,0 @@
-import type { Compute } from './utils.js'
-
-export type StorageItemMap = {
-  recentConnectorId: string
-  state: any
-}
-
-export type Storage<
-  itemMap extends Record<string, unknown> = Record<string, unknown>,
-  ///
-  storageItemMap extends StorageItemMap = StorageItemMap & itemMap,
-> = {
-  key: string
-  getItem<
-    key extends keyof storageItemMap,
-    value extends storageItemMap[key],
-    defaultValue extends value | null | undefined,
-  >(
-    key: key,
-    defaultValue?: defaultValue | undefined
-  ):
-    | (defaultValue extends null ? value | null : value)
-    | Promise<defaultValue extends null ? value | null : value>
-  setItem<
-    key extends keyof storageItemMap,
-    value extends storageItemMap[key] | null,
-  >(key: key, value: value): void | Promise<void>
-  removeItem(key: keyof storageItemMap): void | Promise<void>
-}
-
-export type BaseStorage = {
-  getItem(
-    key: string
-  ): string | null | undefined | Promise<string | null | undefined>
-  setItem(key: string, value: string): void | Promise<void>
-  removeItem(key: string): void | Promise<void>
-}
-
-export type CreateStorageParameters = {
-  deserialize?: (<type>(value: string) => type | unknown) | undefined
-  key?: string | undefined
-  serialize?: (<type>(value: type | any) => string) | undefined
-  storage?: Compute<BaseStorage> | undefined
-}