@msaki/jsonrpc 0.0.1

package/.changeset/README.md

@@ -0,0 +1,8 @@
+# Changesets
+
+Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
+with multi-package repos, or single-package repos to help you version and publish your code. You can
+find the full documentation for it [in our repository](https://github.com/changesets/changesets)
+
+We have a quick list of common questions to get you started engaging with this project in
+[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)

package/.changeset/config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.1.2/schema.json",
+  "changelog": "@changesets/cli/changelog",
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

package/.changeset/hip-trams-reply.md

@@ -0,0 +1,5 @@
+---
+"@msaki/jsonrpc": patch
+---
+
+add changeset and build process

package/README.md

@@ -0,0 +1,29 @@
+# jsonrpc
+
+## Usage
+
+```sh
+import { JsonRpcServer } from "@msaki/jsonrpc";
+
+const server = new JsonRpcServer()
+
+server.register("add", ([a,b]: [number, number]) => a + b)
+server.register("ping", () => "pong")
+
+Bun.serve({
+  port: 4444,
+  async fetch(req) {
+    if (req.method !== "POST") {
+      return new Response("JSON-RPC only", { status: 405 })
+    }
+    const payload = await req.json();
+    const response = await server.handle(payload);
+    if (!response) {
+      return new Response(null, { status: 204 })
+    }
+    return Response.json(response);
+  }
+})
+
+console.log("JSON-RPC sever on http://localhost:4444")
+```

package/dist/index.d.mts

@@ -0,0 +1,47 @@
+type JsonRpcId = string | number | null;
+interface JsonRpcRequest {
+    jsonrpc: "2.0";
+    method: string;
+    params?: unknown;
+    id?: JsonRpcId;
+}
+interface JsonRpcSuccess {
+    jsonrpc: "2.0";
+    result: unknown;
+    id: JsonRpcId;
+}
+interface JsonRpcErrorObject {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+interface JsonRpcError {
+    jsonrpc: "2.0";
+    error: JsonRpcErrorObject;
+    id: JsonRpcId;
+}
+type JsonRpcResponse = JsonRpcSuccess | JsonRpcError;
+
+declare const INVALID_REQUEST = -32600;
+declare const METHOD_NOT_FOUND = -32601;
+declare const INVALID_PARAMS = -32602;
+declare const INTERNAL_ERROR = -32603;
+declare const PARSE_ERROR = -32700;
+declare const REQUEST_ABORTED = -32800;
+type Handler = (params: any) => any | Promise<any>;
+declare class JsonRpcServer {
+    private methods;
+    register(method: string, handler: Handler): void;
+    handle(raw: unknown): Promise<JsonRpcResponse | JsonRpcResponse[] | null>;
+    private error;
+}
+
+declare class JsonRpcClient {
+    private send;
+    private id;
+    constructor(send: (req: JsonRpcRequest) => Promise<JsonRpcResponse>);
+    call<T = unknown>(method: string, params?: unknown): Promise<T>;
+    notify(method: string, params?: unknown): Promise<JsonRpcResponse>;
+}
+
+export { type Handler, INTERNAL_ERROR, INVALID_PARAMS, INVALID_REQUEST, JsonRpcClient, type JsonRpcError, type JsonRpcErrorObject, type JsonRpcId, type JsonRpcRequest, type JsonRpcResponse, JsonRpcServer, type JsonRpcSuccess, METHOD_NOT_FOUND, PARSE_ERROR, REQUEST_ABORTED };

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+type JsonRpcId = string | number | null;
+interface JsonRpcRequest {
+    jsonrpc: "2.0";
+    method: string;
+    params?: unknown;
+    id?: JsonRpcId;
+}
+interface JsonRpcSuccess {
+    jsonrpc: "2.0";
+    result: unknown;
+    id: JsonRpcId;
+}
+interface JsonRpcErrorObject {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+interface JsonRpcError {
+    jsonrpc: "2.0";
+    error: JsonRpcErrorObject;
+    id: JsonRpcId;
+}
+type JsonRpcResponse = JsonRpcSuccess | JsonRpcError;
+
+declare const INVALID_REQUEST = -32600;
+declare const METHOD_NOT_FOUND = -32601;
+declare const INVALID_PARAMS = -32602;
+declare const INTERNAL_ERROR = -32603;
+declare const PARSE_ERROR = -32700;
+declare const REQUEST_ABORTED = -32800;
+type Handler = (params: any) => any | Promise<any>;
+declare class JsonRpcServer {
+    private methods;
+    register(method: string, handler: Handler): void;
+    handle(raw: unknown): Promise<JsonRpcResponse | JsonRpcResponse[] | null>;
+    private error;
+}
+
+declare class JsonRpcClient {
+    private send;
+    private id;
+    constructor(send: (req: JsonRpcRequest) => Promise<JsonRpcResponse>);
+    call<T = unknown>(method: string, params?: unknown): Promise<T>;
+    notify(method: string, params?: unknown): Promise<JsonRpcResponse>;
+}
+
+export { type Handler, INTERNAL_ERROR, INVALID_PARAMS, INVALID_REQUEST, JsonRpcClient, type JsonRpcError, type JsonRpcErrorObject, type JsonRpcId, type JsonRpcRequest, type JsonRpcResponse, JsonRpcServer, type JsonRpcSuccess, METHOD_NOT_FOUND, PARSE_ERROR, REQUEST_ABORTED };

package/dist/index.js

@@ -0,0 +1,133 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// index.ts
+var index_exports = {};
+__export(index_exports, {
+  INTERNAL_ERROR: () => INTERNAL_ERROR,
+  INVALID_PARAMS: () => INVALID_PARAMS,
+  INVALID_REQUEST: () => INVALID_REQUEST,
+  JsonRpcClient: () => JsonRpcClient,
+  JsonRpcServer: () => JsonRpcServer,
+  METHOD_NOT_FOUND: () => METHOD_NOT_FOUND,
+  PARSE_ERROR: () => PARSE_ERROR,
+  REQUEST_ABORTED: () => REQUEST_ABORTED
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/server.ts
+var INVALID_REQUEST = -32600;
+var METHOD_NOT_FOUND = -32601;
+var INVALID_PARAMS = -32602;
+var INTERNAL_ERROR = -32603;
+var PARSE_ERROR = -32700;
+var REQUEST_ABORTED = -32800;
+var JsonRpcServer = class {
+  methods = /* @__PURE__ */ new Map();
+  register(method, handler) {
+    this.methods.set(method, handler);
+  }
+  async handle(raw) {
+    if (Array.isArray(raw)) {
+      if (raw.length === 0) {
+        return this.error(null, INVALID_REQUEST, "Invalid request");
+      }
+      const responses = await Promise.all(
+        raw.map((item) => this.handle(item))
+      );
+      const filtered = responses.filter(
+        (r) => r !== null
+      );
+      return filtered.length > 0 ? filtered : null;
+    }
+    let req = raw;
+    if (typeof req !== "object" || req === null || req.jsonrpc !== "2.0" || typeof req.method !== "string") {
+      return this.error(null, INVALID_REQUEST, "Invalid request");
+    }
+    const id = typeof req?.id === "string" || typeof req?.id === "number" || req?.id === null ? req.id : null;
+    const handler = this.methods.get(req.method);
+    if (!handler) {
+      return id === null ? null : this.error(req.id, METHOD_NOT_FOUND, "Method not found");
+    }
+    try {
+      const result = await handler(req.params);
+      if (req.id === void 0) return null;
+      return {
+        jsonrpc: "2.0",
+        result,
+        id: req.id
+      };
+    } catch (err) {
+      return this.error(
+        req.id ?? null,
+        INTERNAL_ERROR,
+        "Internal error",
+        err instanceof Error ? err.message : err
+      );
+    }
+  }
+  error(id, code, message, data) {
+    return {
+      jsonrpc: "2.0",
+      error: { code, message, data },
+      id: id ?? null
+    };
+  }
+};
+
+// src/client.ts
+var JsonRpcClient = class {
+  constructor(send) {
+    this.send = send;
+  }
+  id = 0;
+  async call(method, params) {
+    const request = {
+      jsonrpc: "2.0",
+      method,
+      params,
+      id: ++this.id
+    };
+    const response = await this.send(request);
+    if ("error" in response) {
+      const e = response.error;
+      throw new Error(`RPC error ${e.code} ${e.message}`);
+    }
+    return response.result;
+  }
+  notify(method, params) {
+    const request = {
+      jsonrpc: "2.0",
+      method,
+      params
+    };
+    return this.send(request);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  INTERNAL_ERROR,
+  INVALID_PARAMS,
+  INVALID_REQUEST,
+  JsonRpcClient,
+  JsonRpcServer,
+  METHOD_NOT_FOUND,
+  PARSE_ERROR,
+  REQUEST_ABORTED
+});

package/dist/index.mjs

@@ -0,0 +1,99 @@
+// src/server.ts
+var INVALID_REQUEST = -32600;
+var METHOD_NOT_FOUND = -32601;
+var INVALID_PARAMS = -32602;
+var INTERNAL_ERROR = -32603;
+var PARSE_ERROR = -32700;
+var REQUEST_ABORTED = -32800;
+var JsonRpcServer = class {
+  methods = /* @__PURE__ */ new Map();
+  register(method, handler) {
+    this.methods.set(method, handler);
+  }
+  async handle(raw) {
+    if (Array.isArray(raw)) {
+      if (raw.length === 0) {
+        return this.error(null, INVALID_REQUEST, "Invalid request");
+      }
+      const responses = await Promise.all(
+        raw.map((item) => this.handle(item))
+      );
+      const filtered = responses.filter(
+        (r) => r !== null
+      );
+      return filtered.length > 0 ? filtered : null;
+    }
+    let req = raw;
+    if (typeof req !== "object" || req === null || req.jsonrpc !== "2.0" || typeof req.method !== "string") {
+      return this.error(null, INVALID_REQUEST, "Invalid request");
+    }
+    const id = typeof req?.id === "string" || typeof req?.id === "number" || req?.id === null ? req.id : null;
+    const handler = this.methods.get(req.method);
+    if (!handler) {
+      return id === null ? null : this.error(req.id, METHOD_NOT_FOUND, "Method not found");
+    }
+    try {
+      const result = await handler(req.params);
+      if (req.id === void 0) return null;
+      return {
+        jsonrpc: "2.0",
+        result,
+        id: req.id
+      };
+    } catch (err) {
+      return this.error(
+        req.id ?? null,
+        INTERNAL_ERROR,
+        "Internal error",
+        err instanceof Error ? err.message : err
+      );
+    }
+  }
+  error(id, code, message, data) {
+    return {
+      jsonrpc: "2.0",
+      error: { code, message, data },
+      id: id ?? null
+    };
+  }
+};
+
+// src/client.ts
+var JsonRpcClient = class {
+  constructor(send) {
+    this.send = send;
+  }
+  id = 0;
+  async call(method, params) {
+    const request = {
+      jsonrpc: "2.0",
+      method,
+      params,
+      id: ++this.id
+    };
+    const response = await this.send(request);
+    if ("error" in response) {
+      const e = response.error;
+      throw new Error(`RPC error ${e.code} ${e.message}`);
+    }
+    return response.result;
+  }
+  notify(method, params) {
+    const request = {
+      jsonrpc: "2.0",
+      method,
+      params
+    };
+    return this.send(request);
+  }
+};
+export {
+  INTERNAL_ERROR,
+  INVALID_PARAMS,
+  INVALID_REQUEST,
+  JsonRpcClient,
+  JsonRpcServer,
+  METHOD_NOT_FOUND,
+  PARSE_ERROR,
+  REQUEST_ABORTED
+};

package/index.ts

@@ -0,0 +1,3 @@
+export * from "./src/types"
+export * from "./src/server";
+export * from "./src/client";

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@msaki/jsonrpc",
+  "author": "Meek Msaki",
+  "version": "0.0.1",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsup index.ts --format cjs,esm --dts",
+    "publish": "bun run build && changeset publish",
+    "lint": "tsc"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.29.8",
+    "@types/bun": "latest",
+    "tsup": "^8.5.1"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  }
+}

package/src/client.ts

@@ -0,0 +1,33 @@
+import type { JsonRpcRequest, JsonRpcResponse } from "./types";
+
+export class JsonRpcClient {
+  private id = 0
+
+  constructor(
+    private send: (req: JsonRpcRequest) => Promise<JsonRpcResponse>
+  ) {}
+
+  async call<T = unknown>(method: string, params?: unknown): Promise<T> {
+    const request: JsonRpcRequest = {
+      jsonrpc: "2.0",
+      method,
+      params,
+      id: ++this.id,
+    }
+    const response = await this.send(request);
+    if ("error" in response) {
+      const e = response.error
+      throw new Error(`RPC error ${e.code} ${e.message}`)
+    }
+    return response.result as T
+  }
+
+  notify(method: string, params?: unknown) {
+    const request: JsonRpcRequest = {
+      jsonrpc: "2.0",
+      method,
+      params
+    }
+    return this.send(request)
+  }
+}

package/src/server.ts

@@ -0,0 +1,88 @@
+import type { JsonRpcResponse,  JsonRpcRequest } from "./types";
+
+export const INVALID_REQUEST  = -32600;
+export const METHOD_NOT_FOUND = -32601;
+export const INVALID_PARAMS   = -32602; // unused
+export const INTERNAL_ERROR   = -32603;
+export const PARSE_ERROR      = -32700; // unused
+export const REQUEST_ABORTED  = -32800; // unused
+
+export type Handler = (params: any) => any | Promise<any>
+
+export class JsonRpcServer {
+  private methods = new Map<string, Handler>()
+
+  register(method: string, handler: Handler) {
+    this.methods.set(method, handler)
+  }
+
+  async handle(
+    raw: unknown, 
+  ): Promise<JsonRpcResponse | JsonRpcResponse[] | null> {
+    // handle batch
+    if (Array.isArray(raw)) {
+      if (raw.length === 0) {
+        return this.error(null, INVALID_REQUEST, "Invalid request")
+      }
+      const responses = await Promise.all(
+        raw.map(item => this.handle(item))
+      )
+        const filtered = responses.filter(
+        (r): r is JsonRpcResponse => r !== null
+      )
+      return filtered.length > 0 ? filtered : null
+    }
+
+    // handle single response
+    let req = raw as Partial<JsonRpcRequest>
+
+    if (
+      typeof req !== "object" ||
+        req === null ||
+        req.jsonrpc !== "2.0" ||
+        typeof req.method !== "string"
+    ) {
+      return this.error(null, INVALID_REQUEST, "Invalid request")
+    }
+    
+    const id = 
+      typeof (req as any)?.id === "string" ||
+      typeof (req as any)?.id === "number" ||
+      (req as any)?.id === null ? (req as any).id : null
+
+    const handler = this.methods.get(req.method)
+    if (!handler) {
+      return id === null ? null : this.error(req.id, METHOD_NOT_FOUND, "Method not found")
+    }
+
+    try {
+      const result = await handler(req.params)
+      if (req.id === undefined) return null // notification
+      return {
+        jsonrpc: "2.0",
+        result,
+        id: req.id
+      }
+    } catch (err) {
+      return this.error(
+        req.id ?? null,
+        INTERNAL_ERROR,
+        "Internal error",
+        err instanceof Error ? err.message : err
+      )
+    }
+  }
+
+  private error(
+    id: JsonRpcRequest["id"],
+    code: number,
+    message: string,
+    data?: unknown
+  ): JsonRpcResponse {
+    return {
+      jsonrpc: "2.0",
+      error: { code, message, data },
+      id: id ?? null
+    }
+  }
+}

package/src/types.ts

@@ -0,0 +1,28 @@
+export type JsonRpcId = string | number | null
+
+export interface JsonRpcRequest {
+  jsonrpc: "2.0"
+  method: string
+  params?: unknown
+  id?: JsonRpcId
+}
+
+export interface JsonRpcSuccess {
+  jsonrpc: "2.0"
+  result: unknown
+  id: JsonRpcId
+}
+
+export interface JsonRpcErrorObject {
+  code: number
+  message: string
+  data?: unknown
+}
+
+export interface JsonRpcError {
+  jsonrpc: "2.0"
+  error: JsonRpcErrorObject
+  id: JsonRpcId
+}
+
+export type JsonRpcResponse = JsonRpcSuccess | JsonRpcError

package/tsconfig.json

@@ -0,0 +1,28 @@
+{
+  "compilerOptions": {
+    // Environment setup & latest features
+    "lib": [
+      "ESNext"
+    ],
+    "target": "ESNext",
+    "module": "Preserve",
+    "moduleDetection": "force",
+    "jsx": "react-jsx",
+    "allowJs": true,
+    // Bundler mode
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+    // Best practices
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+    // Some stricter flags (disabled by default)
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noPropertyAccessFromIndexSignature": false
+  }
+}