@blackglory/cache-js 0.10.1 → 0.10.3

package/README.md

@@ -9,21 +9,26 @@ yarn add @blackglory/cache-js
 ## API
 ### CacheClient
 ```ts
+interface ICacheClientOptions {
+  server: string
+  timeout?: number
+  retryIntervalForReconnection?: number
+}
+
 interface INamespaceStats {
   items: number
 }
 
+interface IItem {
+  value: JSONValue
+  metadata: IItemMetadata
+}
+
 interface IItemMetadata {
   updatedAt: number
   timeToLive: number | null
 }
 
-interface ICacheClientOptions {
-  server: string
-  timeout?: number
-  retryIntervalForReconnection?: number
-}
-
 class CacheClient {
   static create(options: ICacheClientOptions): Promise<CacheClient>
 
@@ -37,12 +42,11 @@ class CacheClient {
 
   hasItem(namespace: string, itemKey: string, timeout?: number): Promise<boolean>
 
-  getItem(namespace: string, itemKey: string, timeout?: number): Promise<
-    {
-      value: JSONValue
-      metadata: IItemMetadata
-    } | null
-  >
+  getItem(
+    namespace: string
+  , itemKey: string
+  , timeout?: number
+  ): Promise<IItem | null>
 
   getItemValue(
     namespace: string

package/lib/cache-client.d.ts

@@ -1,6 +1,6 @@
-import { INamespaceStats, IItemMetadata } from './contract.js';
+import { INamespaceStats, IItem } from './contract.js';
 import { JSONValue } from '@blackglory/prelude';
-export { INamespaceStats, IItemMetadata } from './contract.js';
+export { INamespaceStats, IItem, IItemMetadata } from './contract.js';
 export interface ICacheClientOptions {
     server: string;
     timeout?: number;
@@ -19,10 +19,7 @@ export declare class CacheClient {
     getAllNamespaces(timeout?: number): Promise<string[]>;
     getAllItemKeys(namespace: string, timeout?: number): Promise<string[]>;
     hasItem(namespace: string, itemKey: string, timeout?: number): Promise<boolean>;
-    getItem(namespace: string, itemKey: string, timeout?: number): Promise<{
-        value: JSONValue;
-        metadata: IItemMetadata;
-    } | null>;
+    getItem(namespace: string, itemKey: string, timeout?: number): Promise<IItem | null>;
     getItemValue(namespace: string, itemKey: string, timeout?: number): Promise<JSONValue | null>;
     getItemValues(namespace: string, itemKeys: string[], timeout?: number): Promise<Array<JSONValue | null>>;
     setItem(namespace: string, itemKey: string, itemValue: JSONValue, timeToLive: number | null, timeout?: number): Promise<void>;

package/lib/cache-client.js.map

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

package/lib/contract.d.ts

@@ -3,6 +3,10 @@ export declare const expectedVersion = "^0.9.0";
 export interface INamespaceStats {
     items: number;
 }
+export interface IItem {
+    value: JSONValue;
+    metadata: IItemMetadata;
+}
 export interface IItemMetadata {
     updatedAt: number;
     timeToLive: number | null;
@@ -12,10 +16,7 @@ export interface IAPI {
     getAllItemKeys(namespace: string): string[];
     getNamespaceStats(namespace: string): INamespaceStats;
     hasItem(namespace: string, itemKey: string): boolean;
-    getItem(namespace: string, itemKey: string): {
-        value: JSONValue;
-        metadata: IItemMetadata;
-    } | null;
+    getItem(namespace: string, itemKey: string): IItem | null;
     getItemValue(namespace: string, itemKey: string): JSONValue | null;
     setItem(namespace: string, itemKey: string, itemValue: JSONValue, timeToLive: number | null): null;
     removeItem(namespace: string, itemKey: string): null;

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@blackglory/cache-js",
-  "version": "0.10.1",
+  "version": "0.10.3",
   "description": "",
   "keywords": [],
   "files": [
-    "lib"
+    "lib",
+    "src"
   ],
   "type": "module",
   "main": "lib/index.js",

package/src/cache-client.ts

@@ -0,0 +1,154 @@
+import { createRPCClient } from '@utils/rpc-client.js'
+import { ClientProxy, BatchClient, BatchClientProxy } from 'delight-rpc'
+import { IAPI, INamespaceStats, IItem } from './contract.js'
+import { timeoutSignal, withAbortSignal } from 'extra-abort'
+import { JSONValue } from '@blackglory/prelude'
+export { INamespaceStats, IItem, IItemMetadata } from './contract.js'
+
+export interface ICacheClientOptions {
+  server: string
+  timeout?: number
+  retryIntervalForReconnection?: number
+}
+
+export class CacheClient {
+  static async create(options: ICacheClientOptions): Promise<CacheClient> {
+    const { client, batchClient, proxy, close } = await createRPCClient(
+      options.server
+    , options.retryIntervalForReconnection
+    )
+    return new CacheClient(client, batchClient, proxy, close, options.timeout)
+  }
+
+  private constructor(
+    private client: ClientProxy<IAPI>
+  , private batchClient: BatchClient
+  , private batchProxy: BatchClientProxy<IAPI, unknown>
+  , private closeClients: () => Promise<void>
+  , private timeout?: number
+  ) {}
+
+  async close(): Promise<void> {
+    await this.closeClients()
+  }
+
+  async getNamespaceStats(
+    namespace: string
+  , timeout?: number
+  ): Promise<INamespaceStats> {
+    return await this.withTimeout(
+      () => this.client.getNamespaceStats(namespace)
+    , timeout ?? this.timeout
+    )
+  }
+
+  async getAllNamespaces(timeout?: number): Promise<string[]> {
+    return await this.withTimeout(
+      () => this.client.getAllNamespaces()
+    , timeout ?? this.timeout
+    )
+  }
+
+  async getAllItemKeys(namespace: string, timeout?: number): Promise<string[]> {
+    return await this.withTimeout(
+      () => this.client.getAllItemKeys(namespace)
+    , timeout ?? this.timeout
+    )
+  }
+
+  async hasItem(
+    namespace: string
+  , itemKey: string
+  , timeout?: number
+  ): Promise<boolean> {
+    return await this.withTimeout(
+      () => this.client.hasItem(namespace, itemKey)
+    , timeout ?? this.timeout
+    )
+  }
+
+  async getItem(
+    namespace: string
+  , itemKey: string
+  , timeout?: number
+  ): Promise<IItem | null> {
+    return await this.withTimeout(
+      () => this.client.getItem(namespace, itemKey)
+    , timeout ?? this.timeout
+    )
+  }
+
+  async getItemValue(
+    namespace: string
+  , itemKey: string
+  , timeout?: number
+  ): Promise<JSONValue | null> {
+    return await this.withTimeout(
+      () => this.client.getItemValue(namespace, itemKey)
+    , timeout ?? this.timeout
+    )
+  }
+
+  async getItemValues(
+    namespace: string
+  , itemKeys: string[]
+  , timeout?: number
+  ): Promise<Array<JSONValue | null>> {
+    return await this.withTimeout(
+      async () => {
+        const results = await this.batchClient.parallel(
+          ...itemKeys.map(key => this.batchProxy.getItemValue(namespace, key))
+        )
+        return results.map(result => result.unwrap())
+      }
+    , timeout ?? this.timeout
+    )
+  }
+
+  async setItem(
+    namespace: string
+  , itemKey: string
+  , itemValue: JSONValue
+  , timeToLive: number | null
+  , timeout?: number
+  ): Promise<void> {
+    await this.withTimeout(
+      () => this.client.setItem(
+        namespace
+      , itemKey
+      , itemValue
+      , timeToLive
+      )
+    , timeout ?? this.timeout
+    )
+  }
+
+  async removeItem(
+    namespace: string
+  , itemKey: string
+  , timeout?: number
+  ): Promise<void> {
+    await this.withTimeout(
+      () => this.client.removeItem(namespace, itemKey)
+    , timeout ?? this.timeout
+    )
+  }
+
+  async clearItemsByNamespace(namespace: string, timeout?: number): Promise<void> {
+    await this.withTimeout(
+      () => this.client.clearItemsByNamespace(namespace)
+    , timeout ?? this.timeout
+    )
+  }
+
+  private async withTimeout<T>(
+    fn: () => PromiseLike<T>
+  , timeout: number | undefined = this.timeout
+  ): Promise<T> {
+    if (timeout) {
+      return await withAbortSignal(timeoutSignal(timeout), fn)
+    } else {
+      return await fn()
+    }
+  }
+}

package/src/contract.ts

@@ -0,0 +1,40 @@
+import { JSONValue } from '@blackglory/prelude'
+
+export const expectedVersion = '^0.9.0'
+
+export interface INamespaceStats {
+  items: number
+}
+
+export interface IItem {
+  value: JSONValue
+  metadata: IItemMetadata
+}
+
+export interface IItemMetadata {
+  updatedAt: number
+  timeToLive: number | null
+}
+
+export interface IAPI {
+  getAllNamespaces(): string[]
+  getAllItemKeys(namespace: string): string[]
+
+  getNamespaceStats(namespace: string): INamespaceStats
+
+  hasItem(namespace: string, itemKey: string): boolean
+
+  getItem(namespace: string, itemKey: string): IItem | null
+  getItemValue(namespace: string, itemKey: string): JSONValue | null
+
+  setItem(
+    namespace: string
+  , itemKey: string
+  , itemValue: JSONValue
+  , timeToLive: number | null /* ms */
+  ): null
+
+  removeItem(namespace: string, itemKey: string): null
+
+  clearItemsByNamespace(namespace: string): null
+}

package/src/index.ts

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

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

@@ -0,0 +1,34 @@
+import { IAPI, expectedVersion } from '@src/contract.js'
+import { ClientProxy, BatchClient, BatchClientProxy, createBatchProxy } from 'delight-rpc'
+import { createClient, createBatchClient } 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>
+  batchClient: BatchClient<IAPI>
+  proxy: BatchClientProxy<IAPI, unknown>
+  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 })
+  const [batchClient, closeBatchClient] = createBatchClient(ws, { expectedVersion })
+  const proxy = createBatchProxy<IAPI>()
+
+  return {
+    client
+  , batchClient
+  , proxy
+  , close: async () => {
+      closeClient()
+      closeBatchClient()
+      cancelAutoReconnect()
+      await ws.close()
+    }
+  }
+}

package/src/utils/rpc-client.ts

@@ -0,0 +1,35 @@
+import { IAPI, expectedVersion } from '@src/contract.js'
+import { ClientProxy, BatchClient, BatchClientProxy, createBatchProxy } from 'delight-rpc'
+import { createClient, createBatchClient } 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>
+  batchClient: BatchClient<IAPI>
+  proxy: BatchClientProxy<IAPI, unknown>
+  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 })
+  const [batchClient, closeBatchClient] = createBatchClient(ws, { expectedVersion })
+  const proxy = createBatchProxy<IAPI>()
+
+  return {
+    client
+  , batchClient
+  , proxy
+  , close: async () => {
+      closeClient()
+      closeBatchClient()
+      cancelAutoReconnect()
+      await ws.close()
+    }
+  }
+}