@ckb-ccc/core 0.0.13-alpha.1 → 0.0.13-alpha.3

package/dist.commonjs/client/cache/memory.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientCacheMemory = void 0;
+const index_js_1 = require("../../ckb/index.js");
+const index_js_2 = require("../../hex/index.js");
+const memory_advanced_js_1 = require("./memory.advanced.js");
+class ClientCacheMemory {
+    constructor() {
+        this.cachedTransactions = [];
+        this.unusableOutPoints = [];
+        this.usableCells = [];
+        this.knownCells = [];
+    }
+    async markUsable(...cellLikes) {
+        cellLikes.flat().forEach((cellLike) => {
+            const cell = index_js_1.Cell.from(cellLike).clone();
+            this.usableCells.push(cell);
+            this.knownCells.push(cell);
+            const index = this.unusableOutPoints.findIndex((o) => cell.outPoint.eq(o));
+            if (index !== -1) {
+                this.unusableOutPoints.splice(index, 1);
+            }
+        });
+    }
+    async markUnusable(...outPointLikes) {
+        outPointLikes.flat().forEach((outPointLike) => {
+            const outPoint = index_js_1.OutPoint.from(outPointLike);
+            this.unusableOutPoints.push(outPoint.clone());
+            const index = this.usableCells.findIndex((c) => c.outPoint.eq(outPoint));
+            if (index !== -1) {
+                this.usableCells.splice(index, 1);
+            }
+        });
+    }
+    async markTransactions(...transactionLike) {
+        await Promise.all(transactionLike.flat().map(async (transactionLike) => {
+            const tx = index_js_1.Transaction.from(transactionLike);
+            const txHash = tx.hash();
+            await Promise.all(tx.inputs.map((i) => this.markUnusable(i.previousOutput)));
+            await Promise.all(tx.outputs.map((o, i) => this.markUsable({
+                cellOutput: o,
+                outputData: tx.outputsData[i],
+                outPoint: {
+                    txHash,
+                    index: i,
+                },
+            })));
+        }));
+    }
+    async isUnusable(outPointLike) {
+        const outPoint = index_js_1.OutPoint.from(outPointLike);
+        return this.unusableOutPoints.find((o) => o.eq(outPoint)) !== undefined;
+    }
+    async recordTransactions(...transactions) {
+        this.cachedTransactions.push(...transactions.flat().map(index_js_1.Transaction.from));
+    }
+    async getTransaction(txHashLike) {
+        const txHash = (0, index_js_2.hexFrom)(txHashLike);
+        return this.cachedTransactions.find((tx) => tx.hash() === txHash);
+    }
+    async recordCells(...cells) {
+        this.usableCells.push(...cells.flat().map(index_js_1.Cell.from));
+    }
+    async getCell(outPointLike) {
+        const outPoint = index_js_1.OutPoint.from(outPointLike);
+        return this.usableCells.find((cell) => cell.outPoint.eq(outPoint));
+    }
+    async *findCells(keyLike) {
+        for (const cell of this.usableCells) {
+            if (!(0, memory_advanced_js_1.filterCell)(keyLike, cell)) {
+                continue;
+            }
+            yield cell;
+        }
+    }
+}
+exports.ClientCacheMemory = ClientCacheMemory;

package/dist.commonjs/client/client.d.ts

@@ -1,6 +1,7 @@
-import { Cell, CellDep, CellDepLike, CellLike, OutPointLike, Script, ScriptLike, TransactionLike } from "../ckb/index.js";
+import { Cell, CellDep, CellDepLike, OutPointLike, Script, ScriptLike, TransactionLike } from "../ckb/index.js";
 import { Hex, HexLike } from "../hex/index.js";
 import { Num, NumLike } from "../num/index.js";
+import { ClientCache } from "./cache/index.js";
 import { ClientCollectableSearchKeyLike } from "./clientTypes.advanced.js";
 import { ClientBlock, ClientFindCellsResponse, ClientFindTransactionsGroupedResponse, ClientFindTransactionsResponse, ClientIndexerSearchKeyLike, ClientIndexerSearchKeyTransactionLike, ClientTransactionResponse, OutputsValidator } from "./clientTypes.js";
 /**
@@ -41,10 +42,8 @@ export declare class CellDepInfo {
  * @public
  */
 export declare abstract class Client {
-    private readonly cachedTransactions;
-    private readonly unusableOutPoints;
-    private readonly usableCells;
-    private readonly knownCells;
+    cache: ClientCache;
+    constructor(cache?: ClientCache);
     abstract get url(): string;
     abstract get addressPrefix(): string;
     abstract getKnownScript(script: KnownScript): Promise<Pick<Script, "codeHash" | "hashType"> & {
@@ -53,8 +52,6 @@ export declare abstract class Client {
     abstract getTip(): Promise<Num>;
     abstract getBlockByNumber(blockNumber: NumLike, verbosity?: number | null, withCycles?: boolean | null): Promise<ClientBlock | undefined>;
     abstract getBlockByHash(blockHash: HexLike, verbosity?: number | null, withCycles?: boolean | null): Promise<ClientBlock | undefined>;
-    markUsable(cellLike: CellLike): Promise<void>;
-    markUnusable(outPointLike: OutPointLike): Promise<void>;
     abstract sendTransactionNoCache(transaction: TransactionLike, validator?: OutputsValidator): Promise<Hex>;
     abstract getTransactionNoCache(txHash: HexLike): Promise<ClientTransactionResponse | undefined>;
     getCell(outPointLike: OutPointLike): Promise<Cell | undefined>;

package/dist.commonjs/client/client.d.ts.map

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

package/dist.commonjs/client/client.js

@@ -6,7 +6,7 @@ const index_js_2 = require("../fixedPoint/index.js");
 const index_js_3 = require("../hex/index.js");
 const index_js_4 = require("../num/index.js");
 const index_js_5 = require("../utils/index.js");
-const client_advanced_js_1 = require("./client.advanced.js");
+const memory_js_1 = require("./cache/memory.js");
 const clientTypes_js_1 = require("./clientTypes.js");
 /**
  * @public
@@ -44,34 +44,14 @@ exports.CellDepInfo = CellDepInfo;
  * @public
  */
 class Client {
-    constructor() {
-        this.cachedTransactions = [];
-        this.unusableOutPoints = [];
-        this.usableCells = [];
-        this.knownCells = [];
-    }
-    async markUsable(cellLike) {
-        const cell = index_js_1.Cell.from(cellLike).clone();
-        this.usableCells.push(cell);
-        this.knownCells.push(cell);
-        const index = this.unusableOutPoints.findIndex((o) => cell.outPoint.eq(o));
-        if (index !== -1) {
-            this.unusableOutPoints.splice(index, 1);
-        }
-    }
-    async markUnusable(outPointLike) {
-        const outPoint = index_js_1.OutPoint.from(outPointLike);
-        this.unusableOutPoints.push(outPoint.clone());
-        const index = this.usableCells.findIndex((c) => c.outPoint.eq(outPoint));
-        if (index !== -1) {
-            this.usableCells.splice(index, 1);
-        }
+    constructor(cache = new memory_js_1.ClientCacheMemory()) {
+        this.cache = cache;
     }
     async getCell(outPointLike) {
         const outPoint = index_js_1.OutPoint.from(outPointLike);
-        const cached = this.knownCells.find((cell) => cell.outPoint.eq(outPoint));
+        const cached = await this.cache.getCell(outPoint);
         if (cached) {
-            return cached.clone();
+            return cached;
         }
         const transaction = await this.getTransactionNoCache(outPoint.txHash);
         if (!transaction) {
@@ -86,12 +66,12 @@ class Client {
             cellOutput: transaction.transaction.outputs[index],
             outputData: transaction.transaction.outputsData[index] ?? "0x",
         });
-        this.knownCells.push(cell);
-        return cell.clone();
+        await this.cache.recordCells(cell);
+        return cell;
     }
     async findCellsPaged(key, order, limit, after) {
         const res = await this.findCellsPagedNoCache(key, order, limit, after);
-        this.knownCells.push(...res.cells);
+        await this.cache.recordCells(res.cells);
         return res;
     }
     async *findCells(key, order, limit = 10) {
@@ -116,15 +96,12 @@ class Client {
     async *findCellsByCollectableSearchKey(keyLike, order, limit = 10) {
         const key = clientTypes_js_1.ClientIndexerSearchKey.from(keyLike);
         const foundedOutPoints = [];
-        for (const cell of this.usableCells) {
-            if (!(0, client_advanced_js_1.filterCell)(key, cell)) {
-                continue;
-            }
+        for await (const cell of this.cache.findCells(key)) {
             foundedOutPoints.push(cell.outPoint);
             yield cell;
         }
         for await (const cell of this.findCells(key, order, limit)) {
-            if (this.unusableOutPoints.some((o) => o.eq(cell.outPoint)) ||
+            if ((await this.cache.isUnusable(cell.outPoint)) ||
                 foundedOutPoints.some((founded) => founded.eq(cell.outPoint))) {
                 continue;
             }
@@ -220,16 +197,8 @@ class Client {
     async sendTransaction(transaction, validator) {
         const tx = index_js_1.Transaction.from(transaction);
         const txHash = await this.sendTransactionNoCache(tx, validator);
-        this.cachedTransactions.push(tx.clone());
-        await Promise.all(tx.inputs.map((i) => this.markUnusable(i.previousOutput)));
-        await Promise.all(tx.outputs.map((o, i) => this.markUsable({
-            cellOutput: o,
-            outputData: tx.outputsData[i],
-            outPoint: {
-                txHash,
-                index: i,
-            },
-        })));
+        await this.cache.recordTransactions(tx);
+        await this.cache.markTransactions(tx);
         return txHash;
     }
     async getTransaction(txHashLike) {
@@ -238,7 +207,7 @@ class Client {
         if (res?.transaction) {
             return res;
         }
-        const tx = this.cachedTransactions.find((t) => t.hash() === txHash);
+        const tx = await this.cache.getTransaction(txHash);
         if (!tx) {
             return;
         }

package/dist.commonjs/client/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./cache/index.js";
 export * from "./client.js";
 export * from "./clientPublicMainnet.js";
 export * from "./clientPublicTestnet.js";

package/dist.commonjs/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC"}

package/dist.commonjs/client/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./cache/index.js"), exports);
 __exportStar(require("./client.js"), exports);
 __exportStar(require("./clientPublicMainnet.js"), exports);
 __exportStar(require("./clientPublicTestnet.js"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckb-ccc/core",
-  "version": "0.0.13-alpha.1",
+  "version": "0.0.13-alpha.3",
   "description": "Core of CCC - CKBer's Codebase",
   "author": "Hanssen0 <hanssen0@hanssen0.com>",
   "license": "MIT",

package/src/client/advanced.ts

@@ -1,4 +1,4 @@
-export * from "./client.advanced.js";
+export * from "./cache/advanced.js";
 export * from "./clientPublicMainnet.advanced.js";
 export * from "./clientPublicTestnet.advanced.js";
 export * from "./clientTypes.advanced.js";

package/src/client/cache/advanced.ts

@@ -0,0 +1 @@
+export * from "./memory.advanced.js";

package/src/client/cache/cache.ts

@@ -0,0 +1,30 @@
+import {
+  Cell,
+  CellLike,
+  OutPointLike,
+  Transaction,
+  TransactionLike,
+} from "../../ckb/index.js";
+import { HexLike } from "../../hex/index.js";
+import { ClientCollectableSearchKeyLike } from "../clientTypes.advanced.js";
+
+export interface ClientCache {
+  markUsable(...cellLikes: (CellLike | CellLike[])[]): Promise<void>;
+  markUnusable(
+    ...outPointLike: (OutPointLike | OutPointLike[])[]
+  ): Promise<void>;
+  markTransactions(
+    ...transactionLike: (TransactionLike | TransactionLike[])[]
+  ): Promise<void>;
+
+  isUnusable(outPointLike: OutPointLike): Promise<boolean>;
+
+  recordTransactions(
+    ...transactions: (TransactionLike | TransactionLike[])[]
+  ): Promise<void>;
+  getTransaction(txHash: HexLike): Promise<Transaction | undefined>;
+
+  recordCells(...cells: (CellLike | CellLike[])[]): Promise<void>;
+  getCell(outPoint: OutPointLike): Promise<Cell | undefined>;
+  findCells(filter: ClientCollectableSearchKeyLike): AsyncGenerator<Cell>;
+}

package/src/client/cache/index.ts

@@ -0,0 +1,2 @@
+export * from "./cache.js";
+export * from "./memory.js";

package/src/client/{client.advanced.ts → cache/memory.advanced.ts}

@@ -1,12 +1,12 @@
-import { bytesFrom } from "../bytes/index.js";
-import { Cell, CellLike, Script, ScriptLike } from "../ckb/index.js";
-import { HexLike, hexFrom } from "../hex/index.js";
-import { NumLike, numFrom } from "../num/index.js";
+import { bytesFrom } from "../../bytes/index.js";
+import { Cell, CellLike, Script, ScriptLike } from "../../ckb/index.js";
+import { HexLike, hexFrom } from "../../hex/index.js";
+import { NumLike, numFrom } from "../../num/index.js";
 import {
   ClientCollectableSearchKeyLike,
   clientSearchKeyRangeFrom,
-} from "./clientTypes.advanced.js";
-import { ClientIndexerSearchKey } from "./clientTypes.js";
+} from "../clientTypes.advanced.js";
+import { ClientIndexerSearchKey } from "../clientTypes.js";
 
 export function filterData(
   dataLike: HexLike,

package/src/client/cache/memory.ts

@@ -0,0 +1,110 @@
+import {
+  Cell,
+  CellLike,
+  OutPoint,
+  OutPointLike,
+  Transaction,
+  TransactionLike,
+} from "../../ckb/index.js";
+import { HexLike, hexFrom } from "../../hex/index.js";
+import { ClientCollectableSearchKeyLike } from "../clientTypes.advanced.js";
+import { ClientCache } from "./cache.js";
+import { filterCell } from "./memory.advanced.js";
+
+export class ClientCacheMemory implements ClientCache {
+  private readonly cachedTransactions: Transaction[] = [];
+  private readonly unusableOutPoints: OutPoint[] = [];
+  private readonly usableCells: Cell[] = [];
+  private readonly knownCells: Cell[] = [];
+
+  async markUsable(...cellLikes: (CellLike | CellLike[])[]): Promise<void> {
+    cellLikes.flat().forEach((cellLike) => {
+      const cell = Cell.from(cellLike).clone();
+      this.usableCells.push(cell);
+      this.knownCells.push(cell);
+
+      const index = this.unusableOutPoints.findIndex((o) =>
+        cell.outPoint.eq(o),
+      );
+      if (index !== -1) {
+        this.unusableOutPoints.splice(index, 1);
+      }
+    });
+  }
+
+  async markUnusable(
+    ...outPointLikes: (OutPointLike | OutPointLike[])[]
+  ): Promise<void> {
+    outPointLikes.flat().forEach((outPointLike) => {
+      const outPoint = OutPoint.from(outPointLike);
+      this.unusableOutPoints.push(outPoint.clone());
+
+      const index = this.usableCells.findIndex((c) => c.outPoint.eq(outPoint));
+      if (index !== -1) {
+        this.usableCells.splice(index, 1);
+      }
+    });
+  }
+
+  async markTransactions(
+    ...transactionLike: (TransactionLike | TransactionLike[])[]
+  ): Promise<void> {
+    await Promise.all(
+      transactionLike.flat().map(async (transactionLike) => {
+        const tx = Transaction.from(transactionLike);
+        const txHash = tx.hash();
+
+        await Promise.all(
+          tx.inputs.map((i) => this.markUnusable(i.previousOutput)),
+        );
+        await Promise.all(
+          tx.outputs.map((o, i) =>
+            this.markUsable({
+              cellOutput: o,
+              outputData: tx.outputsData[i],
+              outPoint: {
+                txHash,
+                index: i,
+              },
+            }),
+          ),
+        );
+      }),
+    );
+  }
+
+  async isUnusable(outPointLike: OutPointLike): Promise<boolean> {
+    const outPoint = OutPoint.from(outPointLike);
+    return this.unusableOutPoints.find((o) => o.eq(outPoint)) !== undefined;
+  }
+
+  async recordTransactions(
+    ...transactions: (TransactionLike | TransactionLike[])[]
+  ): Promise<void> {
+    this.cachedTransactions.push(...transactions.flat().map(Transaction.from));
+  }
+  async getTransaction(txHashLike: HexLike): Promise<Transaction | undefined> {
+    const txHash = hexFrom(txHashLike);
+    return this.cachedTransactions.find((tx) => tx.hash() === txHash);
+  }
+
+  async recordCells(...cells: (CellLike | CellLike[])[]): Promise<void> {
+    this.usableCells.push(...cells.flat().map(Cell.from));
+  }
+  async getCell(outPointLike: OutPointLike): Promise<Cell | undefined> {
+    const outPoint = OutPoint.from(outPointLike);
+    return this.usableCells.find((cell) => cell.outPoint.eq(outPoint));
+  }
+
+  async *findCells(
+    keyLike: ClientCollectableSearchKeyLike,
+  ): AsyncGenerator<Cell> {
+    for (const cell of this.usableCells) {
+      if (!filterCell(keyLike, cell)) {
+        continue;
+      }
+
+      yield cell;
+    }
+  }
+}

package/src/client/client.ts

@@ -2,7 +2,6 @@ import {
   Cell,
   CellDep,
   CellDepLike,
-  CellLike,
   OutPoint,
   OutPointLike,
   Script,
@@ -14,7 +13,8 @@ import { Zero } from "../fixedPoint/index.js";
 import { Hex, HexLike, hexFrom } from "../hex/index.js";
 import { Num, NumLike, numFrom } from "../num/index.js";
 import { apply, reduceAsync } from "../utils/index.js";
-import { filterCell } from "./client.advanced.js";
+import { ClientCache } from "./cache/index.js";
+import { ClientCacheMemory } from "./cache/memory.js";
 import { ClientCollectableSearchKeyLike } from "./clientTypes.advanced.js";
 import {
   ClientBlock,
@@ -76,10 +76,7 @@ export class CellDepInfo {
  * @public
  */
 export abstract class Client {
-  private readonly cachedTransactions: Transaction[] = [];
-  private readonly unusableOutPoints: OutPoint[] = [];
-  private readonly usableCells: Cell[] = [];
-  private readonly knownCells: Cell[] = [];
+  constructor(public cache: ClientCache = new ClientCacheMemory()) {}
 
   abstract get url(): string;
   abstract get addressPrefix(): string;
@@ -102,27 +99,6 @@ export abstract class Client {
     withCycles?: boolean | null,
   ): Promise<ClientBlock | undefined>;
 
-  async markUsable(cellLike: CellLike): Promise<void> {
-    const cell = Cell.from(cellLike).clone();
-    this.usableCells.push(cell);
-    this.knownCells.push(cell);
-
-    const index = this.unusableOutPoints.findIndex((o) => cell.outPoint.eq(o));
-    if (index !== -1) {
-      this.unusableOutPoints.splice(index, 1);
-    }
-  }
-
-  async markUnusable(outPointLike: OutPointLike): Promise<void> {
-    const outPoint = OutPoint.from(outPointLike);
-    this.unusableOutPoints.push(outPoint.clone());
-
-    const index = this.usableCells.findIndex((c) => c.outPoint.eq(outPoint));
-    if (index !== -1) {
-      this.usableCells.splice(index, 1);
-    }
-  }
-
   abstract sendTransactionNoCache(
     transaction: TransactionLike,
     validator?: OutputsValidator,
@@ -133,10 +109,10 @@ export abstract class Client {
 
   async getCell(outPointLike: OutPointLike): Promise<Cell | undefined> {
     const outPoint = OutPoint.from(outPointLike);
-    const cached = this.knownCells.find((cell) => cell.outPoint.eq(outPoint));
+    const cached = await this.cache.getCell(outPoint);
 
     if (cached) {
-      return cached.clone();
+      return cached;
     }
 
     const transaction = await this.getTransactionNoCache(outPoint.txHash);
@@ -154,8 +130,8 @@ export abstract class Client {
       cellOutput: transaction.transaction.outputs[index],
       outputData: transaction.transaction.outputsData[index] ?? "0x",
     });
-    this.knownCells.push(cell);
-    return cell.clone();
+    await this.cache.recordCells(cell);
+    return cell;
   }
 
   abstract findCellsPagedNoCache(
@@ -171,7 +147,7 @@ export abstract class Client {
     after?: string,
   ): Promise<ClientFindCellsResponse> {
     const res = await this.findCellsPagedNoCache(key, order, limit, after);
-    this.knownCells.push(...res.cells);
+    await this.cache.recordCells(res.cells);
     return res;
   }
 
@@ -213,18 +189,14 @@ export abstract class Client {
     const key = ClientIndexerSearchKey.from(keyLike);
     const foundedOutPoints = [];
 
-    for (const cell of this.usableCells) {
-      if (!filterCell(key, cell)) {
-        continue;
-      }
-
+    for await (const cell of this.cache.findCells(key)) {
       foundedOutPoints.push(cell.outPoint);
       yield cell;
     }
 
     for await (const cell of this.findCells(key, order, limit)) {
       if (
-        this.unusableOutPoints.some((o) => o.eq(cell.outPoint)) ||
+        (await this.cache.isUnusable(cell.outPoint)) ||
         foundedOutPoints.some((founded) => founded.eq(cell.outPoint))
       ) {
         continue;
@@ -506,22 +478,9 @@ export abstract class Client {
 
     const txHash = await this.sendTransactionNoCache(tx, validator);
 
-    this.cachedTransactions.push(tx.clone());
-    await Promise.all(
-      tx.inputs.map((i) => this.markUnusable(i.previousOutput)),
-    );
-    await Promise.all(
-      tx.outputs.map((o, i) =>
-        this.markUsable({
-          cellOutput: o,
-          outputData: tx.outputsData[i],
-          outPoint: {
-            txHash,
-            index: i,
-          },
-        }),
-      ),
-    );
+    await this.cache.recordTransactions(tx);
+    await this.cache.markTransactions(tx);
+
     return txHash;
   }
 
@@ -534,7 +493,7 @@ export abstract class Client {
       return res;
     }
 
-    const tx = this.cachedTransactions.find((t) => t.hash() === txHash);
+    const tx = await this.cache.getTransaction(txHash);
     if (!tx) {
       return;
     }

package/src/client/index.ts

@@ -1,3 +1,4 @@
+export * from "./cache/index.js";
 export * from "./client.js";
 export * from "./clientPublicMainnet.js";
 export * from "./clientPublicTestnet.js";

package/dist/client/client.advanced.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.advanced.d.ts","sourceRoot":"","sources":["../../src/client/client.advanced.ts"],"names":[],"mappings":"AACA,OAAO,EAAQ,QAAQ,EAAU,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,OAAO,EAAW,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAW,MAAM,iBAAiB,CAAC;AACnD,OAAO,EACL,8BAA8B,EAE/B,MAAM,2BAA2B,CAAC;AAGnC,wBAAgB,UAAU,CACxB,QAAQ,EAAE,OAAO,EACjB,UAAU,EAAE,OAAO,GAAG,SAAS,EAC/B,UAAU,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,GACzC,OAAO,CAgBT;AAED,wBAAgB,YAAY,CAC1B,SAAS,EAAE,UAAU,GAAG,SAAS,EACjC,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,UAAU,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,GACzC,OAAO,CAkBT;AAED,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,OAAO,EACnB,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,SAAS,GACpC,OAAO,CAQT;AAED,wBAAgB,sBAAsB,CACpC,SAAS,CAAC,EAAE,UAAU,EACtB,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,GAClC,OAAO,CAYT;AAED,wBAAgB,UAAU,CACxB,aAAa,EAAE,8BAA8B,EAC7C,QAAQ,EAAE,QAAQ,GACjB,OAAO,CA4CT"}

package/dist.commonjs/client/client.advanced.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.advanced.d.ts","sourceRoot":"","sources":["../../src/client/client.advanced.ts"],"names":[],"mappings":"AACA,OAAO,EAAQ,QAAQ,EAAU,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,OAAO,EAAW,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAW,MAAM,iBAAiB,CAAC;AACnD,OAAO,EACL,8BAA8B,EAE/B,MAAM,2BAA2B,CAAC;AAGnC,wBAAgB,UAAU,CACxB,QAAQ,EAAE,OAAO,EACjB,UAAU,EAAE,OAAO,GAAG,SAAS,EAC/B,UAAU,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,GACzC,OAAO,CAgBT;AAED,wBAAgB,YAAY,CAC1B,SAAS,EAAE,UAAU,GAAG,SAAS,EACjC,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,UAAU,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,GACzC,OAAO,CAkBT;AAED,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,OAAO,EACnB,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,SAAS,GACpC,OAAO,CAQT;AAED,wBAAgB,sBAAsB,CACpC,SAAS,CAAC,EAAE,UAAU,EACtB,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,GAClC,OAAO,CAYT;AAED,wBAAgB,UAAU,CACxB,aAAa,EAAE,8BAA8B,EAC7C,QAAQ,EAAE,QAAQ,GACjB,OAAO,CA4CT"}