@lidofinance/rpc 0.0.3

package/README.md

@@ -0,0 +1,44 @@
+# @lidofinance/rpc
+
+Fetch extension to use it with RPC endpoints.
+
+## Installation
+
+`yarn add @lidofinance/rpc`
+
+## Getting started
+
+You can just use it as normal `fetch`, there are just a few types restrictions, and it will set right HTTP method for
+you.
+
+```ts
+fetchRPC(url, { body: req.body })
+```
+
+## Examples
+
+### Caching
+
+Here is an example how you can extend `fetchRpc` by adding caching
+
+```ts
+import { FetchRpc, fetchRpc } from '@lidofinance/rpc'
+import { Cache } from 'memory-cache'
+
+export type CachedFetchRPC = FetchRpc<{ cacheKey: string }>
+
+// Just a sample how to use extend fetchRPC
+export const cachedFetchRpcFactory = (timeout: number): CachedFetchRPC => {
+  const cache = new Cache<string, Response>()
+
+  return async (url, init, { cacheKey }) => {
+    const cachedValue = cache.get(cacheKey)
+    if (cachedValue != null) {
+      return cachedValue
+    }
+    const response = await fetchRpc(url, init)
+    cache.put(cacheKey, response, timeout)
+    return response
+  }
+}
+```

package/dist/index.cjs

@@ -0,0 +1,65 @@
+function $parcel$exportWildcard(dest, source) {
+  Object.keys(source).forEach(function(key) {
+    if (key === 'default' || key === '__esModule' || dest.hasOwnProperty(key)) {
+      return;
+    }
+
+    Object.defineProperty(dest, key, {
+      enumerable: true,
+      get: function get() {
+        return source[key];
+      }
+    });
+  });
+
+  return dest;
+}
+function $parcel$export(e, n, v, s) {
+  Object.defineProperty(e, n, {get: v, set: s, enumerable: true, configurable: true});
+}
+var $3d6d7d97961b05c0$exports = {};
+
+$parcel$export($3d6d7d97961b05c0$exports, "fetchRpc", function () { return $3d6d7d97961b05c0$export$51ee03a558564558; });
+const $3d6d7d97961b05c0$export$51ee03a558564558 = (url, init)=>fetch(url, {
+        ...init,
+        method: "POST",
+        body: JSON.stringify(init.body)
+    });
+
+
+var $f5c96785547d6405$exports = {};
+
+$parcel$export($f5c96785547d6405$exports, "ExhaustedIterationError", function () { return $f5c96785547d6405$export$544290ca59c30f2b; });
+$parcel$export($f5c96785547d6405$exports, "iterateUrls", function () { return $f5c96785547d6405$export$874e79e4fbe19379; });
+class $f5c96785547d6405$export$544290ca59c30f2b extends Error {
+    constructor(message){
+        super(message !== null && message !== void 0 ? message : "Iteration ended without success");
+    }
+}
+const $f5c96785547d6405$export$874e79e4fbe19379 = async (urls, callback, onError)=>{
+    let lastResponse;
+    let lastError;
+    for (const url of urls)try {
+        const response = await callback(url);
+        lastResponse = response;
+        // We want to return first succeeded response
+        if (response instanceof Response && !response.ok) continue;
+        return response;
+    } catch (error) {
+        onError === null || onError === void 0 ? void 0 : onError(error);
+        lastError = error;
+    }
+    // If there are no succeeded responses, return last not thrown
+    if (lastResponse != null) return lastResponse;
+    // If there are no responses at all, throw last error
+    if (lastError != null) throw lastError;
+    // This should not be reachable
+    throw new $f5c96785547d6405$export$544290ca59c30f2b();
+};
+
+
+$parcel$exportWildcard(module.exports, $3d6d7d97961b05c0$exports);
+$parcel$exportWildcard(module.exports, $f5c96785547d6405$exports);
+
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"mappings":";;;;;;;;;;;;;;;;;;;;;;ACoBO,MAAM,yCAAQ,GAAa,CAAC,GAAG,EAAE,IAAI,GAC1C,KAAK,CAAC,GAAG,EAAE;QACT,GAAG,IAAI;QACP,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;KAChC,CAAC;;ADzBJ;;;;;AEAO,MAAM,yCAAuB,SAAS,KAAK;IAChD,YAAY,OAAgB,CAAE;QAC5B,KAAK,CAAC,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,iCAAiC,CAAC;KACpD;CACF;AAEM,MAAM,yCAAW,GAAG,OACzB,IAA2B,EAC3B,QAA4B,EAC5B,OAAqC,GACtB;IACf,IAAI,YAAY,AAAe;IAC/B,IAAI,SAAS,AAAqB;IAElC,KAAK,MAAM,GAAG,IAAI,IAAI,CACpB,IAAI;QACF,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC;QACpC,YAAY,GAAG,QAAQ;QAEvB,6CAA6C;QAC7C,IAAI,QAAQ,YAAY,QAAQ,IAAI,CAAC,QAAQ,CAAC,EAAE,EAC9C,SAAQ;QAGV,OAAO,QAAQ,CAAA;KAChB,CAAC,OAAO,KAAK,EAAE;QACd,OAAO,aAAP,OAAO,WAAS,GAAhB,KAAA,CAAgB,GAAhB,OAAO,CAAG,KAAK,CAAC,CAAA;QAChB,SAAS,GAAG,KAAK;KAClB;IAGH,8DAA8D;IAC9D,IAAI,YAAY,IAAI,IAAI,EACtB,OAAO,YAAY,CAAA;IAErB,qDAAqD;IACrD,IAAI,SAAS,IAAI,IAAI,EACnB,MAAM,SAAS,CAAA;IAEjB,+BAA+B;IAC/B,MAAM,IAAI,yCAAuB,EAAE,CAAA;CACpC;","sources":["packages/core/rpc/src/index.ts","packages/core/rpc/src/fetchRpc.ts","packages/core/rpc/src/iterateUrls.ts"],"sourcesContent":["export * from './fetchRpc'\nexport * from './iterateUrls'\n","export type FetchRpcInitBody = {\n  jsonrpc: '1.0' | '2.0' | string\n  method: string\n  params?: unknown\n  id?: string | number | null\n}\n\n// eslint-disable-next-line no-undef\nexport type FetchRpcInit = Omit<RequestInit, 'body' | 'method'> & {\n  method?: 'POST'\n  body: FetchRpcInitBody | FetchRpcInitBody[]\n}\n\n// Need Extension type so we can extend fetchRPC with metrics tracking or caching\nexport type FetchRpc<Extension extends Record<string | number, unknown> | void = void> = (\n  url: string,\n  init: FetchRpcInit,\n  extension: Extension,\n) => Promise<Response>\n\nexport const fetchRpc: FetchRpc = (url, init) =>\n  fetch(url, {\n    ...init,\n    method: 'POST',\n    body: JSON.stringify(init.body),\n  })\n","export class ExhaustedIterationError extends Error {\n  constructor(message?: string) {\n    super(message ?? 'Iteration ended without success')\n  }\n}\n\nexport const iterateUrls = async <T>(\n  urls: [string, ...string[]],\n  callback: (url: string) => T,\n  onError?: (error: unknown) => unknown,\n): Promise<T> => {\n  let lastResponse: T | undefined\n  let lastError: unknown | undefined\n\n  for (const url of urls) {\n    try {\n      const response = await callback(url)\n      lastResponse = response\n\n      // We want to return first succeeded response\n      if (response instanceof Response && !response.ok) {\n        continue\n      }\n\n      return response\n    } catch (error) {\n      onError?.(error)\n      lastError = error\n    }\n  }\n\n  // If there are no succeeded responses, return last not thrown\n  if (lastResponse != null) {\n    return lastResponse\n  }\n  // If there are no responses at all, throw last error\n  if (lastError != null) {\n    throw lastError\n  }\n  // This should not be reachable\n  throw new ExhaustedIterationError()\n}\n"],"names":[],"version":3,"file":"index.cjs.map"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export type FetchRpcInitBody = {
+    jsonrpc: '1.0' | '2.0' | string;
+    method: string;
+    params?: unknown;
+    id?: string | number | null;
+};
+export type FetchRpcInit = Omit<RequestInit, 'body' | 'method'> & {
+    method?: 'POST';
+    body: FetchRpcInitBody | FetchRpcInitBody[];
+};
+export type FetchRpc<Extension extends Record<string | number, unknown> | void = void> = (url: string, init: FetchRpcInit, extension: Extension) => Promise<Response>;
+export const fetchRpc: FetchRpc;
+export class ExhaustedIterationError extends Error {
+    constructor(message?: string);
+}
+export const iterateUrls: <T>(urls: [string, ...string[]], callback: (url: string) => T, onError?: ((error: unknown) => unknown) | undefined) => Promise<T>;
+
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAAA,+BAA+B;IAC7B,OAAO,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;CAC5B,CAAA;AAGD,2BAA2B,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,GAAG;IAChE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,CAAA;CAC5C,CAAA;AAGD,qBAAqB,SAAS,SAAS,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,IAAI,IAAI,CACvF,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,SAAS,KACjB,OAAO,CAAC,QAAQ,CAAC,CAAA;AAEtB,OAAO,MAAM,UAAU,QAKnB,CAAA;ACzBJ,oCAAqC,SAAQ,KAAK;gBACpC,OAAO,CAAC,EAAE,MAAM;CAG7B;AAED,OAAO,MAAM,uBACL,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,kBACX,MAAM,2BACJ,OAAO,KAAK,OAAO,4BAgCtC,CAAA","sources":["packages/core/rpc/src/src/fetchRpc.ts","packages/core/rpc/src/src/iterateUrls.ts","packages/core/rpc/src/src/index.ts","packages/core/rpc/src/index.ts"],"sourcesContent":[null,null,null,"export * from './fetchRpc'\nexport * from './iterateUrls'\n"],"names":[],"version":3,"file":"index.d.ts.map"}

package/dist/index.mjs

@@ -0,0 +1,48 @@
+function $parcel$export(e, n, v, s) {
+  Object.defineProperty(e, n, {get: v, set: s, enumerable: true, configurable: true});
+}
+var $c4a16dc5cb85fe9d$exports = {};
+
+$parcel$export($c4a16dc5cb85fe9d$exports, "fetchRpc", function () { return $c4a16dc5cb85fe9d$export$51ee03a558564558; });
+const $c4a16dc5cb85fe9d$export$51ee03a558564558 = (url, init)=>fetch(url, {
+        ...init,
+        method: "POST",
+        body: JSON.stringify(init.body)
+    });
+
+
+var $83a6df06ccf0d0e9$exports = {};
+
+$parcel$export($83a6df06ccf0d0e9$exports, "ExhaustedIterationError", function () { return $83a6df06ccf0d0e9$export$544290ca59c30f2b; });
+$parcel$export($83a6df06ccf0d0e9$exports, "iterateUrls", function () { return $83a6df06ccf0d0e9$export$874e79e4fbe19379; });
+class $83a6df06ccf0d0e9$export$544290ca59c30f2b extends Error {
+    constructor(message){
+        super(message !== null && message !== void 0 ? message : "Iteration ended without success");
+    }
+}
+const $83a6df06ccf0d0e9$export$874e79e4fbe19379 = async (urls, callback, onError)=>{
+    let lastResponse;
+    let lastError;
+    for (const url of urls)try {
+        const response = await callback(url);
+        lastResponse = response;
+        // We want to return first succeeded response
+        if (response instanceof Response && !response.ok) continue;
+        return response;
+    } catch (error) {
+        onError === null || onError === void 0 ? void 0 : onError(error);
+        lastError = error;
+    }
+    // If there are no succeeded responses, return last not thrown
+    if (lastResponse != null) return lastResponse;
+    // If there are no responses at all, throw last error
+    if (lastError != null) throw lastError;
+    // This should not be reachable
+    throw new $83a6df06ccf0d0e9$export$544290ca59c30f2b();
+};
+
+
+
+
+export {$c4a16dc5cb85fe9d$export$51ee03a558564558 as fetchRpc, $83a6df06ccf0d0e9$export$544290ca59c30f2b as ExhaustedIterationError, $83a6df06ccf0d0e9$export$874e79e4fbe19379 as iterateUrls};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"mappings":";;;;;;ACoBO,MAAM,yCAAQ,GAAa,CAAC,GAAG,EAAE,IAAI,GAC1C,KAAK,CAAC,GAAG,EAAE;QACT,GAAG,IAAI;QACP,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;KAChC,CAAC;;ADzBJ;;;;;AEAO,MAAM,yCAAuB,SAAS,KAAK;IAChD,YAAY,OAAgB,CAAE;QAC5B,KAAK,CAAC,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,iCAAiC,CAAC;KACpD;CACF;AAEM,MAAM,yCAAW,GAAG,OACzB,IAA2B,EAC3B,QAA4B,EAC5B,OAAqC,GACtB;IACf,IAAI,YAAY,AAAe;IAC/B,IAAI,SAAS,AAAqB;IAElC,KAAK,MAAM,GAAG,IAAI,IAAI,CACpB,IAAI;QACF,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC;QACpC,YAAY,GAAG,QAAQ;QAEvB,6CAA6C;QAC7C,IAAI,QAAQ,YAAY,QAAQ,IAAI,CAAC,QAAQ,CAAC,EAAE,EAC9C,SAAQ;QAGV,OAAO,QAAQ,CAAA;KAChB,CAAC,OAAO,KAAK,EAAE;QACd,OAAO,aAAP,OAAO,WAAS,GAAhB,KAAA,CAAgB,GAAhB,OAAO,CAAG,KAAK,CAAC,CAAA;QAChB,SAAS,GAAG,KAAK;KAClB;IAGH,8DAA8D;IAC9D,IAAI,YAAY,IAAI,IAAI,EACtB,OAAO,YAAY,CAAA;IAErB,qDAAqD;IACrD,IAAI,SAAS,IAAI,IAAI,EACnB,MAAM,SAAS,CAAA;IAEjB,+BAA+B;IAC/B,MAAM,IAAI,yCAAuB,EAAE,CAAA;CACpC;","sources":["packages/core/rpc/src/index.ts","packages/core/rpc/src/fetchRpc.ts","packages/core/rpc/src/iterateUrls.ts"],"sourcesContent":["export * from './fetchRpc'\nexport * from './iterateUrls'\n","export type FetchRpcInitBody = {\n  jsonrpc: '1.0' | '2.0' | string\n  method: string\n  params?: unknown\n  id?: string | number | null\n}\n\n// eslint-disable-next-line no-undef\nexport type FetchRpcInit = Omit<RequestInit, 'body' | 'method'> & {\n  method?: 'POST'\n  body: FetchRpcInitBody | FetchRpcInitBody[]\n}\n\n// Need Extension type so we can extend fetchRPC with metrics tracking or caching\nexport type FetchRpc<Extension extends Record<string | number, unknown> | void = void> = (\n  url: string,\n  init: FetchRpcInit,\n  extension: Extension,\n) => Promise<Response>\n\nexport const fetchRpc: FetchRpc = (url, init) =>\n  fetch(url, {\n    ...init,\n    method: 'POST',\n    body: JSON.stringify(init.body),\n  })\n","export class ExhaustedIterationError extends Error {\n  constructor(message?: string) {\n    super(message ?? 'Iteration ended without success')\n  }\n}\n\nexport const iterateUrls = async <T>(\n  urls: [string, ...string[]],\n  callback: (url: string) => T,\n  onError?: (error: unknown) => unknown,\n): Promise<T> => {\n  let lastResponse: T | undefined\n  let lastError: unknown | undefined\n\n  for (const url of urls) {\n    try {\n      const response = await callback(url)\n      lastResponse = response\n\n      // We want to return first succeeded response\n      if (response instanceof Response && !response.ok) {\n        continue\n      }\n\n      return response\n    } catch (error) {\n      onError?.(error)\n      lastError = error\n    }\n  }\n\n  // If there are no succeeded responses, return last not thrown\n  if (lastResponse != null) {\n    return lastResponse\n  }\n  // If there are no responses at all, throw last error\n  if (lastError != null) {\n    throw lastError\n  }\n  // This should not be reachable\n  throw new ExhaustedIterationError()\n}\n"],"names":[],"version":3,"file":"index.mjs.map"}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@lidofinance/rpc",
+  "description": "Fetch extension to use it with RPC endpoints",
+  "repository": "git@github.com:lidofinance/lido-ui-blocks.git",
+  "license": "MIT",
+  "version": "0.0.3",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">= 16",
+    "browsers": "> 0.5%, last 2 versions, not dead"
+  },
+  "source": "./src/index.ts",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "parcel build",
+    "format": "prettier --check src",
+    "format:fix": "yarn format --write",
+    "types": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@lidofinance/config-prettier": "0.0.1"
+  }
+}