feat(nestjs-json-rpc): default transport for rpc

- http transport
- validation
- explorer need service

Closes: #77

Author: klerick

.verdaccio/config.yml

@@ -3,12 +3,14 @@ import { LoggerModule } from 'nestjs-pino';
 
 import { DatabaseModule } from 'database';
 import { ResourcesModule } from './resources/resources.module';
+import { RpcModule } from './rpc/rpc.module';
 import * as process from 'process';
 
 @Module({
   imports: [
     DatabaseModule,
     ResourcesModule,
+    RpcModule,
     LoggerModule.forRoot({
       pinoHttp: {
         level: process.env['NODE_ENV'] === 'test' ? 'silent' : 'debug',

apps/json-api-server/src/app/app.module.ts

@@ -0,0 +1,13 @@
+import { Module } from '@nestjs/common';
+import { NestjsJsonRpcModule, TransportType } from '@klerick/nestjs-json-rpc';
+
+@Module({
+  imports: [
+    NestjsJsonRpcModule.forRootAsync({
+      path: 'rpc',
+      transport: TransportType.HTTP,
+    }),
+  ],
+  // providers: [ContestRpc, ParseIntArrayPipe, LineUpSchemaPipe],
+})
+export class RpcModule {}

apps/json-api-server/src/app/rpc/rpc.module.ts

@@ -0,0 +1,25 @@
+{
+  "extends": ["../../../.eslintrc.base.json"],
+  "ignorePatterns": ["!**/*"],
+  "overrides": [
+    {
+      "files": ["*.ts", "*.tsx", "*.js", "*.jsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.ts", "*.tsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.js", "*.jsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.json"],
+      "parser": "jsonc-eslint-parser",
+      "rules": {
+        "@nx/dependency-checks": "error"
+      }
+    }
+  ]
+}

libs/json-rpc/nestjs-json-rpc/.eslintrc.json

@@ -0,0 +1,11 @@
+# nestjs-json-rpc
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build nestjs-json-rpc` to build the library.
+
+## Running unit tests
+
+Run `nx test nestjs-json-rpc` to execute the unit tests via [Jest](https://jestjs.io).

libs/json-rpc/nestjs-json-rpc/README.md

@@ -0,0 +1,11 @@
+/* eslint-disable */
+export default {
+  displayName: 'nestjs-json-rpc',
+  preset: '../../../jest.preset.js',
+  testEnvironment: 'node',
+  transform: {
+    '^.+\\.[tj]s$': ['ts-jest', { tsconfig: '<rootDir>/tsconfig.spec.json' }],
+  },
+  moduleFileExtensions: ['ts', 'js', 'html'],
+  coverageDirectory: '../../../coverage/libs/json-rpc/nestjs-json-rpc',
+};

libs/json-rpc/nestjs-json-rpc/jest.config.ts

@@ -0,0 +1,10 @@
+{
+  "name": "@klerick/nestjs-json-rpc",
+  "version": "0.0.1",
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "typings": "./src/index.d.ts"
+}

libs/json-rpc/nestjs-json-rpc/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "nestjs-json-rpc",
+  "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "libs/json-rpc/nestjs-json-rpc/src",
+  "projectType": "library",
+  "targets": {
+    "build": {
+      "executor": "@nx/js:tsc",
+      "outputs": ["{options.outputPath}"],
+      "options": {
+        "outputPath": "dist/libs/json-rpc/nestjs-json-rpc",
+        "tsConfig": "libs/json-rpc/nestjs-json-rpc/tsconfig.lib.json",
+        "packageJson": "libs/json-rpc/nestjs-json-rpc/package.json",
+        "main": "libs/json-rpc/nestjs-json-rpc/src/index.ts",
+        "assets": ["libs/json-rpc/nestjs-json-rpc/*.md"]
+      }
+    },
+    "publish": {
+      "command": "node tools/scripts/publish.mjs nestjs-json-rpc {args.ver} {args.tag}",
+      "dependsOn": ["build"]
+    }
+  },
+  "tags": []
+}

libs/json-rpc/nestjs-json-rpc/project.json

@@ -0,0 +1,7 @@
+export * from './lib/nestjs-json-rpc.module';
+export { TransportType, CommonRpcConfig, ErrorCodeType } from './lib/types';
+export {
+  fromRpcErrorToRpcErrorObject,
+  createError,
+  RpcError,
+} from './lib/utils';

libs/json-rpc/nestjs-json-rpc/src/index.ts

@@ -0,0 +1,18 @@
+import { ErrorCodeType } from '../types';
+
+export const JsonRpcMetadataKey = '__rpc-metadata__';
+export const JsonRpcMetadataKeyParamPipe = '__rpc-metadata-param-pipe__';
+
+export const MAP_HANDLER = Symbol('MAP_HANDLER');
+export const RPC_CONTEXT = Symbol('RPC_CONTEXT');
+export const ASYNC_ITERATOR_FACTORY = Symbol('ASYNC_ITERATOR_FACTORY');
+export const ZOD_INPUT_DATA = Symbol('ZOD_INPUT_DATA');
+
+export const ErrorCode: Record<ErrorCodeType, number> = {
+  [ErrorCodeType.ParseError]: -32700,
+  [ErrorCodeType.InvalidRequest]: -32600,
+  [ErrorCodeType.MethodNotFound]: -32601,
+  [ErrorCodeType.InvalidParams]: -32602,
+  [ErrorCodeType.InternalError]: -32603,
+  [ErrorCodeType.ServerError]: -32000,
+} as const;