@blackglory/geyser-js 0.9.0 → 0.10.0

package/README.md

@@ -25,29 +25,32 @@ class GeyserClient {
 
   close(): Promise<void>
 
-  getAllRateLimiterIds(timeout?: number): Promise<string[]>
+  getAllRateLimiterIds(signal?: AbortSignal): Promise<string[]>
 
-  getRateLimiter(rateLimiterId: string, timeout?: number): Promise<IRateLimiterConfig | null>
+  getRateLimiter(
+    rateLimiterId: string
+  , signal?: AbortSignal
+  ): Promise<IRateLimiterConfig | null>
 
   setRateLimiter(
     rateLimiterId: string
   , config: IRateLimiterConfig
-  , timeout?: number
+  , signal?: AbortSignal
   ): Promise<void>
 
-  removeRateLimiter(rateLimiterId: string, timeout?: number): Promise<void>
+  removeRateLimiter(rateLimiterId: string, signal?: AbortSignal): Promise<void>
 
   /**
    * 重置速率限制器的状态.
    * 
    * @throws {RateLimiterNotFound}
    */
-  resetRateLimiter(rateLimiterId: string, timeout?: number): Promise<void>
+  resetRateLimiter(rateLimiterId: string, signal?: AbortSignal): Promise<void>
 
   /**
    * @throws {RateLimiterNotFound}
    */
-  acquireToken(rateLimiterId: string, timeout?: number): Promise<void>
+  acquireToken(rateLimiterId: string, signal?: AbortSignal): Promise<void>
 }
 
 /**

package/lib/geyser-client.d.ts

@@ -12,11 +12,11 @@ export declare class GeyserClient {
     static create(options: IGeyserClientOptions): Promise<GeyserClient>;
     private constructor();
     close(): Promise<void>;
-    getAllRateLimiterIds(timeout?: number): Promise<string[]>;
-    getRateLimiter(rateLimiterId: string, timeout?: number): Promise<IRateLimiterConfig | null>;
-    setRateLimiter(rateLimiterId: string, config: IRateLimiterConfig, timeout?: number): Promise<void>;
-    removeRateLimiter(rateLimiterId: string, timeout?: number): Promise<void>;
-    resetRateLimiter(rateLimiterId: string, timeout?: number): Promise<void>;
-    acquireToken(rateLimiterId: string, timeout?: number): Promise<void>;
+    getAllRateLimiterIds(signal?: AbortSignal): Promise<string[]>;
+    getRateLimiter(rateLimiterId: string, signal?: AbortSignal): Promise<IRateLimiterConfig | null>;
+    setRateLimiter(rateLimiterId: string, config: IRateLimiterConfig, signal?: AbortSignal): Promise<void>;
+    removeRateLimiter(rateLimiterId: string, signal?: AbortSignal): Promise<void>;
+    resetRateLimiter(rateLimiterId: string, signal?: AbortSignal): Promise<void>;
+    acquireToken(rateLimiterId: string, signal?: AbortSignal): Promise<void>;
     private withTimeout;
 }

package/lib/geyser-client.js

@@ -1,44 +1,43 @@
 import { createRPCClient } from "./utils/rpc-client.js";
-import { timeoutSignal, withAbortSignal } from 'extra-abort';
+import { raceAbortSignals, timeoutSignal } from 'extra-abort';
+import { isntUndefined } from '@blackglory/prelude';
 export { RateLimiterNotFound } from './contract.js';
 export class GeyserClient {
+    static async create(options) {
+        const { client, close } = await createRPCClient(options.server, options.retryIntervalForReconnection);
+        return new GeyserClient(client, close, options.timeout);
+    }
     constructor(client, closeClients, timeout) {
         this.client = client;
         this.closeClients = closeClients;
         this.timeout = timeout;
     }
-    static async create(options) {
-        const { client, close } = await createRPCClient(options.server, options.retryIntervalForReconnection);
-        return new GeyserClient(client, close, options.timeout);
-    }
     async close() {
         await this.closeClients();
     }
-    async getAllRateLimiterIds(timeout) {
-        return await this.withTimeout(() => this.client.getAllRateLimiterIds(), timeout !== null && timeout !== void 0 ? timeout : this.timeout);
+    async getAllRateLimiterIds(signal) {
+        return await this.client.getAllRateLimiterIds(this.withTimeout(signal));
     }
-    async getRateLimiter(rateLimiterId, timeout) {
-        return await this.withTimeout(() => this.client.getRateLimiter(rateLimiterId), timeout !== null && timeout !== void 0 ? timeout : this.timeout);
+    async getRateLimiter(rateLimiterId, signal) {
+        return await this.client.getRateLimiter(rateLimiterId, this.withTimeout(signal));
     }
-    async setRateLimiter(rateLimiterId, config, timeout) {
-        await this.withTimeout(() => this.client.setRateLimiter(rateLimiterId, config), timeout !== null && timeout !== void 0 ? timeout : this.timeout);
+    async setRateLimiter(rateLimiterId, config, signal) {
+        await this.client.setRateLimiter(rateLimiterId, config, this.withTimeout(signal));
     }
-    async removeRateLimiter(rateLimiterId, timeout) {
-        await this.withTimeout(() => this.client.removeRateLimiter(rateLimiterId), timeout !== null && timeout !== void 0 ? timeout : this.timeout);
+    async removeRateLimiter(rateLimiterId, signal) {
+        await this.client.removeRateLimiter(rateLimiterId, this.withTimeout(signal));
     }
-    async resetRateLimiter(rateLimiterId, timeout) {
-        await this.withTimeout(() => this.client.removeRateLimiter(rateLimiterId), timeout !== null && timeout !== void 0 ? timeout : this.timeout);
+    async resetRateLimiter(rateLimiterId, signal) {
+        await this.client.removeRateLimiter(rateLimiterId, this.withTimeout(signal));
     }
-    async acquireToken(rateLimiterId, timeout) {
-        await this.withTimeout(() => this.client.acquireToken(rateLimiterId), timeout !== null && timeout !== void 0 ? timeout : this.timeout);
+    async acquireToken(rateLimiterId, signal) {
+        await this.client.acquireToken(rateLimiterId, this.withTimeout(signal));
     }
-    async withTimeout(fn, timeout = this.timeout) {
-        if (timeout) {
-            return await withAbortSignal(timeoutSignal(timeout), fn);
-        }
-        else {
-            return await fn();
-        }
+    withTimeout(signal) {
+        return raceAbortSignals([
+            isntUndefined(this.timeout) && timeoutSignal(this.timeout),
+            signal
+        ]);
     }
 }
 //# sourceMappingURL=geyser-client.js.map

package/lib/geyser-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"geyser-client.js","sourceRoot":"","sources":["../src/geyser-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"geyser-client.js","sourceRoot":"","sources":["../src/geyser-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,8BAA4B;AAEtD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE7D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAsB,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAQvE,MAAM,OAAO,YAAY;IACvB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAA6B;QAC/C,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,eAAe,CAC7C,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,4BAA4B,CACrC,CAAA;QACD,OAAO,IAAI,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;IACzD,CAAC;IAED,YACU,MAAyB,EACzB,YAAiC,EACjC,OAAgB;QAFhB,WAAM,GAAN,MAAM,CAAmB;QACzB,iBAAY,GAAZ,YAAY,CAAqB;QACjC,YAAO,GAAP,OAAO,CAAS;IACvB,CAAC;IAEJ,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,YAAY,EAAE,CAAA;IAC3B,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,MAAoB;QAC7C,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAA;IACzE,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,aAAqB,EACrB,MAAoB;QAEpB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,CACrC,aAAa,EACb,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CACzB,CAAA;IACH,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,aAAqB,EACrB,MAA0B,EAC1B,MAAoB;QAEpB,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,CAC9B,aAAa,EACb,MAAM,EACN,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CACzB,CAAA;IACH,CAAC;IAED,KAAK,CAAC,iBAAiB,CACrB,aAAqB,EACrB,MAAoB;QAEpB,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,aAAa,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAA;IAC9E,CAAC;IAOD,KAAK,CAAC,gBAAgB,CACpB,aAAqB,EACrB,MAAoB;QAEpB,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,aAAa,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAA;IAC9E,CAAC;IAKD,KAAK,CAAC,YAAY,CAAC,aAAqB,EAAE,MAAoB;QAC5D,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,aAAa,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAA;IACzE,CAAC;IAEO,WAAW,CAAC,MAAoB;QACtC,OAAO,gBAAgB,CAAC;YACtB,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC;YAC1D,MAAM;SACP,CAAC,CAAA;IACJ,CAAC;CACF"}

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@blackglory/geyser-js",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "",
   "keywords": [],
   "files": [
-    "lib"
+    "lib",
+    "src"
   ],
   "type": "module",
   "main": "lib/index.js",
@@ -17,22 +18,20 @@
   "license": "MIT",
   "sideEffects": false,
   "engines": {
-    "node": ">=16"
+    "node": ">=22"
   },
   "scripts": {
     "prepare": "ts-patch install -s",
-    "lint": "eslint --ext .js,.jsx,.ts,.tsx --quiet src __tests__",
-    "test": "cross-env NODE_OPTIONS=--experimental-vm-modules jest --no-cache --runInBand --config jest.config.cjs",
-    "test:debug": "cross-env NODE_OPTIONS=--experimental-vm-modules node --inspect-brk node_modules/.bin/jest --runInBand jest.config.cjs",
-    "test:coverage": "cross-env NODE_OPTIONS=--experimental-vm-modules jest --coverage --config jest.config.cjs",
+    "lint": "eslint --quiet src __tests__",
+    "test": "vitest --run",
     "prepublishOnly": "run-s prepare clean build",
     "clean": "rimraf lib",
     "build": "tsc --project tsconfig.build.json",
     "docker:test": "run-s docker:test:clean docker:test:build docker:test:run docker:test:clean",
     "docker:coverage": "run-s docker:test:clean docker:test:build docker:test:coverage docker:test:clean",
-    "docker:test:build": "docker-compose --project-name estore-js --file docker-compose.test.yml build",
-    "docker:test:run": "docker-compose --project-name estore-js --file docker-compose.test.yml run --rm test",
-    "docker:test:clean": "docker-compose --project-name estore-js --file docker-compose.test.yml down",
+    "docker:test:build": "docker compose --project-name estore-js --file docker-compose.test.yml build",
+    "docker:test:run": "docker compose --project-name estore-js --file docker-compose.test.yml run --no-TTY --rm test",
+    "docker:test:clean": "docker compose --project-name estore-js --file docker-compose.test.yml down",
     "release": "standard-version"
   },
   "husky": {
@@ -42,39 +41,37 @@
     }
   },
   "devDependencies": {
-    "@blackglory/jest-resolver": "^0.3.0",
-    "@commitlint/cli": "^17.5.1",
-    "@commitlint/config-conventional": "^17.4.4",
-    "@types/jest": "^29.5.0",
-    "@types/ws": "^8.5.4",
-    "@typescript-eslint/eslint-plugin": "^5.57.0",
-    "@typescript-eslint/parser": "^5.57.0",
+    "@commitlint/cli": "^19.8.1",
+    "@commitlint/config-conventional": "^19.8.1",
+    "@eslint/js": "^9.27.0",
+    "@types/ws": "^8.18.1",
     "cross-env": "^7.0.3",
-    "eslint": "^8.36.0",
+    "eslint": "^9.27.0",
     "husky": "4",
-    "jest": "^29.5.0",
-    "jest-resolve": "^29.5.0",
-    "msw": "^1.2.1",
+    "msw": "^2.8.6",
     "npm-run-all": "^4.1.5",
-    "return-style": "^3.0.0",
-    "rimraf": "^3.0.2",
+    "return-style": "^3.0.1",
+    "rimraf": "^6.0.1",
     "standard-version": "^9.3.2",
-    "ts-jest": "^29.0.5",
-    "ts-patch": "^2.1.0",
-    "tslib": "^2.5.0",
-    "typescript": "4.8",
-    "typescript-transform-paths": "^3.4.6"
+    "ts-patch": "^3.3.0",
+    "tslib": "^2.8.1",
+    "typescript": "5.8.3",
+    "typescript-eslint": "^8.33.0",
+    "typescript-transform-paths": "^3.5.5",
+    "vite": "^6.3.5",
+    "vite-tsconfig-paths": "^5.1.4",
+    "vitest": "^3.1.4"
   },
   "dependencies": {
-    "@blackglory/errors": "^3.0.0",
-    "@blackglory/prelude": "^0.3.1",
-    "@delight-rpc/extra-native-websocket": "^0.5.2",
-    "@delight-rpc/extra-websocket": "^0.6.2",
+    "@blackglory/errors": "^3.0.3",
+    "@blackglory/prelude": "^0.4.0",
+    "@delight-rpc/extra-native-websocket": "^0.6.0",
+    "@delight-rpc/extra-websocket": "^0.7.0",
     "delight-rpc": "^6.1.2",
-    "extra-abort": "^0.3.6",
-    "extra-native-websocket": "^0.3.1",
-    "extra-websocket": "^0.3.1",
-    "justypes": "^4.2.0",
-    "ws": "^8.13.0"
+    "extra-abort": "^0.4.0",
+    "extra-native-websocket": "^0.4.1",
+    "extra-websocket": "^0.4.2",
+    "justypes": "^4.4.1",
+    "ws": "^8.18.2"
   }
 }

package/src/contract.ts

@@ -0,0 +1,34 @@
+import { JSONObject } from 'justypes'
+import { CustomError } from '@blackglory/errors'
+
+export const expectedVersion = '^0.5.0'
+
+export interface IRateLimiterConfig extends JSONObject {
+  duration: number | null
+  limit: number | null
+}
+
+export interface IAPI {
+  getAllRateLimiterIds(): string[]
+
+  getRateLimiter(rateLimiterId: string): IRateLimiterConfig | null
+  setRateLimiter(rateLimiterId: string, config: IRateLimiterConfig): null
+  removeRateLimiter(rateLimiterId: string): null
+
+  /**
+   * 重置速率限制器的状态.
+   * 
+   * @throws {RateLimiterNotFound}
+   */
+  resetRateLimiter(rateLimiterId: string): null
+
+  /**
+   * @throws {RateLimiterNotFound}
+   */
+  acquireToken(rateLimiterId: string): null
+}
+
+/**
+ * 速率限制器在未经配置的情况下, 相当于不存在.
+ */
+export class RateLimiterNotFound extends CustomError {}

package/src/geyser-client.ts

@@ -0,0 +1,91 @@
+import { createRPCClient } from '@utils/rpc-client.js'
+import { ClientProxy } from 'delight-rpc'
+import { raceAbortSignals, timeoutSignal } from 'extra-abort'
+import { IAPI, IRateLimiterConfig } from './contract.js'
+import { isntUndefined } from '@blackglory/prelude'
+export { IRateLimiterConfig, RateLimiterNotFound } from './contract.js'
+
+export interface IGeyserClientOptions {
+  server: string
+  timeout?: number
+  retryIntervalForReconnection?: number
+}
+
+export class GeyserClient {
+  static async create(options: IGeyserClientOptions): Promise<GeyserClient> {
+    const { client, close } = await createRPCClient(
+      options.server
+    , options.retryIntervalForReconnection
+    )
+    return new GeyserClient(client, close, options.timeout)
+  }
+
+  private constructor(
+    private client: ClientProxy<IAPI>
+  , private closeClients: () => Promise<void>
+  , private timeout?: number
+  ) {}
+
+  async close(): Promise<void> {
+    await this.closeClients()
+  }
+
+  async getAllRateLimiterIds(signal?: AbortSignal): Promise<string[]> {
+    return await this.client.getAllRateLimiterIds(this.withTimeout(signal))
+  }
+
+  async getRateLimiter(
+    rateLimiterId: string
+  , signal?: AbortSignal
+  ): Promise<IRateLimiterConfig | null> {
+    return await this.client.getRateLimiter(
+      rateLimiterId
+    , this.withTimeout(signal)
+    )
+  }
+
+  async setRateLimiter(
+    rateLimiterId: string
+  , config: IRateLimiterConfig
+  , signal?: AbortSignal
+  ): Promise<void> {
+    await this.client.setRateLimiter(
+      rateLimiterId
+    , config
+    , this.withTimeout(signal)
+    )
+  }
+
+  async removeRateLimiter(
+    rateLimiterId: string
+  , signal?: AbortSignal
+  ): Promise<void> {
+    await this.client.removeRateLimiter(rateLimiterId, this.withTimeout(signal))
+  }
+
+  /**
+   * 重置速率限制器的状态.
+   * 
+   * @throws {RateLimiterNotFound}
+   */
+  async resetRateLimiter(
+    rateLimiterId: string
+  , signal?: AbortSignal
+  ): Promise<void> {
+    await this.client.removeRateLimiter(rateLimiterId, this.withTimeout(signal))
+  }
+
+  /**
+   * @throws {RateLimiterNotFound}
+   */
+  async acquireToken(rateLimiterId: string, signal?: AbortSignal): Promise<void> {
+    await this.client.acquireToken(rateLimiterId, this.withTimeout(signal))
+  }
+
+  private withTimeout(signal?: AbortSignal): AbortSignal {
+    return raceAbortSignals([
+      isntUndefined(this.timeout) && timeoutSignal(this.timeout)
+    , signal
+    ])
+  }
+}

package/src/index.ts

@@ -0,0 +1 @@
+export * from './geyser-client.js'

package/src/utils/rpc-client.browser.ts

@@ -0,0 +1,27 @@
+import { IAPI, expectedVersion } from '@src/contract.js'
+import { ClientProxy } from 'delight-rpc'
+import { createClient } from '@delight-rpc/extra-native-websocket'
+import { ExtraNativeWebSocket, autoReconnect } from 'extra-native-websocket'
+
+export async function createRPCClient(
+  url: string
+, retryIntervalForReconnection?: number
+): Promise<{
+  client: ClientProxy<IAPI>
+  close: () => Promise<void>
+}> {
+  const ws = new ExtraNativeWebSocket(() => new WebSocket(url))
+  const cancelAutoReconnect = autoReconnect(ws, retryIntervalForReconnection)
+  await ws.connect()
+
+  const [client, closeClient] = createClient<IAPI>(ws, { expectedVersion })
+
+  return {
+    client
+  , close: async () => {
+      closeClient()
+      cancelAutoReconnect()
+      await ws.close()
+    }
+  }
+}

package/src/utils/rpc-client.ts

@@ -0,0 +1,28 @@
+import { IAPI, expectedVersion } from '@src/contract.js'
+import { ClientProxy } from 'delight-rpc'
+import { createClient } from '@delight-rpc/extra-websocket'
+import { WebSocket } from 'ws'
+import { ExtraWebSocket, autoReconnect } from 'extra-websocket'
+
+export async function createRPCClient(
+  url: string
+, retryIntervalForReconnection?: number
+): Promise<{
+  client: ClientProxy<IAPI>
+  close: () => Promise<void>
+}> {
+  const ws = new ExtraWebSocket(() => new WebSocket(url))
+  const cancelAutoReconnect = autoReconnect(ws, retryIntervalForReconnection)
+  await ws.connect()
+
+  const [client, closeClient] = createClient<IAPI>(ws, { expectedVersion })
+
+  return {
+    client
+  , close: async () => {
+      closeClient()
+      cancelAutoReconnect()
+      await ws.close()
+    }
+  }
+}