@pl4dr/rpc-core 1001.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chan Nyein Thaw
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,127 @@
+"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);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  JSON_RPC_ERROR_CODES_BY_KEY: () => JSON_RPC_ERROR_CODES_BY_KEY,
+  RPC_ERROR_CODE: () => RPC_ERROR_CODE,
+  RPC_ERROR_KEY: () => RPC_ERROR_KEY
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/error.ts
+var RPC_ERROR_CODE = {
+  PARSE_ERROR: 400,
+  BAD_REQUEST: 400,
+  UNAUTHORIZED: 401,
+  FORBIDDEN: 403,
+  NOT_FOUND: 404,
+  METHOD_NOT_SUPPORTED: 405,
+  TIMEOUT: 408,
+  CONFLICT: 409,
+  PRECONDITION_FAILED: 412,
+  PAYLOAD_TOO_LARGE: 413,
+  UNSUPPORTED_MEDIA_TYPE: 415,
+  UNPROCESSABLE_CONTENT: 422,
+  TOO_MANY_REQUESTS: 429,
+  CLIENT_CLOSED_REQUEST: 499,
+  INTERNAL_SERVER_ERROR: 500,
+  NOT_IMPLEMENTED: 501,
+  BAD_GATEWAY: 502,
+  SERVICE_UNAVAILABLE: 503,
+  GATEWAY_TIMEOUT: 504
+};
+var RPC_ERROR_KEY = {
+  400: "PARSE_ERROR",
+  401: "UNAUTHORIZED",
+  403: "FORBIDDEN",
+  404: "NOT_FOUND",
+  405: "METHOD_NOT_SUPPORTED",
+  408: "TIMEOUT",
+  409: "CONFLICT",
+  412: "PRECONDITION_FAILED",
+  413: "PAYLOAD_TOO_LARGE",
+  415: "UNSUPPORTED_MEDIA_TYPE",
+  422: "UNPROCESSABLE_CONTENT",
+  429: "TOO_MANY_REQUESTS",
+  499: "CLIENT_CLOSED_REQUEST",
+  500: "INTERNAL_SERVER_ERROR",
+  501: "NOT_IMPLEMENTED",
+  502: "BAD_GATEWAY",
+  503: "SERVICE_UNAVAILABLE",
+  504: "GATEWAY_TIMEOUT"
+};
+var JSON_RPC_ERROR_CODES_BY_KEY = {
+  /**
+   * Invalid JSON was received by the server.
+   * An error occurred on the server while parsing the JSON text.
+   */
+  PARSE_ERROR: -32700,
+  /**
+   * The JSON sent is not a valid Request object.
+   */
+  BAD_REQUEST: -32600,
+  // 400
+  // Internal JSON-RPC error
+  INTERNAL_SERVER_ERROR: -32603,
+  // 500
+  NOT_IMPLEMENTED: -32603,
+  // 501
+  BAD_GATEWAY: -32603,
+  // 502
+  SERVICE_UNAVAILABLE: -32603,
+  // 503
+  GATEWAY_TIMEOUT: -32603,
+  // 504
+  // Implementation specific errors
+  UNAUTHORIZED: -32001,
+  // 401
+  FORBIDDEN: -32003,
+  // 403
+  NOT_FOUND: -32004,
+  // 404
+  METHOD_NOT_SUPPORTED: -32005,
+  // 405
+  TIMEOUT: -32008,
+  // 408
+  CONFLICT: -32009,
+  // 409
+  PRECONDITION_FAILED: -32012,
+  // 412
+  PAYLOAD_TOO_LARGE: -32013,
+  // 413
+  UNSUPPORTED_MEDIA_TYPE: -32015,
+  // 415
+  UNPROCESSABLE_CONTENT: -32022,
+  // 422
+  TOO_MANY_REQUESTS: -32029,
+  // 429
+  CLIENT_CLOSED_REQUEST: -32099
+  // 499
+};
+
+// src/router/types.ts
+var import_zod = require("zod");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  JSON_RPC_ERROR_CODES_BY_KEY,
+  RPC_ERROR_CODE,
+  RPC_ERROR_KEY
+});

package/dist/index.d.cts

@@ -0,0 +1,138 @@
+import { ZodIssue, Schema } from 'zod';
+import { ResultAsync } from 'neverthrow';
+
+declare const RPC_ERROR_CODE: {
+    readonly PARSE_ERROR: 400;
+    readonly BAD_REQUEST: 400;
+    readonly UNAUTHORIZED: 401;
+    readonly FORBIDDEN: 403;
+    readonly NOT_FOUND: 404;
+    readonly METHOD_NOT_SUPPORTED: 405;
+    readonly TIMEOUT: 408;
+    readonly CONFLICT: 409;
+    readonly PRECONDITION_FAILED: 412;
+    readonly PAYLOAD_TOO_LARGE: 413;
+    readonly UNSUPPORTED_MEDIA_TYPE: 415;
+    readonly UNPROCESSABLE_CONTENT: 422;
+    readonly TOO_MANY_REQUESTS: 429;
+    readonly CLIENT_CLOSED_REQUEST: 499;
+    readonly INTERNAL_SERVER_ERROR: 500;
+    readonly NOT_IMPLEMENTED: 501;
+    readonly BAD_GATEWAY: 502;
+    readonly SERVICE_UNAVAILABLE: 503;
+    readonly GATEWAY_TIMEOUT: 504;
+};
+declare const RPC_ERROR_KEY: {
+    readonly 400: "PARSE_ERROR";
+    readonly 401: "UNAUTHORIZED";
+    readonly 403: "FORBIDDEN";
+    readonly 404: "NOT_FOUND";
+    readonly 405: "METHOD_NOT_SUPPORTED";
+    readonly 408: "TIMEOUT";
+    readonly 409: "CONFLICT";
+    readonly 412: "PRECONDITION_FAILED";
+    readonly 413: "PAYLOAD_TOO_LARGE";
+    readonly 415: "UNSUPPORTED_MEDIA_TYPE";
+    readonly 422: "UNPROCESSABLE_CONTENT";
+    readonly 429: "TOO_MANY_REQUESTS";
+    readonly 499: "CLIENT_CLOSED_REQUEST";
+    readonly 500: "INTERNAL_SERVER_ERROR";
+    readonly 501: "NOT_IMPLEMENTED";
+    readonly 502: "BAD_GATEWAY";
+    readonly 503: "SERVICE_UNAVAILABLE";
+    readonly 504: "GATEWAY_TIMEOUT";
+};
+/**
+ * JSON-RPC 2.0 Error codes
+ *
+ * `-32000` to `-32099` are reserved for implementation-defined server-errors.
+ * For tRPC we're copying the last digits of HTTP 4XX errors.
+ */
+declare const JSON_RPC_ERROR_CODES_BY_KEY: {
+    /**
+     * Invalid JSON was received by the server.
+     * An error occurred on the server while parsing the JSON text.
+     */
+    readonly PARSE_ERROR: -32700;
+    /**
+     * The JSON sent is not a valid Request object.
+     */
+    readonly BAD_REQUEST: -32600;
+    readonly INTERNAL_SERVER_ERROR: -32603;
+    readonly NOT_IMPLEMENTED: -32603;
+    readonly BAD_GATEWAY: -32603;
+    readonly SERVICE_UNAVAILABLE: -32603;
+    readonly GATEWAY_TIMEOUT: -32603;
+    readonly UNAUTHORIZED: -32001;
+    readonly FORBIDDEN: -32003;
+    readonly NOT_FOUND: -32004;
+    readonly METHOD_NOT_SUPPORTED: -32005;
+    readonly TIMEOUT: -32008;
+    readonly CONFLICT: -32009;
+    readonly PRECONDITION_FAILED: -32012;
+    readonly PAYLOAD_TOO_LARGE: -32013;
+    readonly UNSUPPORTED_MEDIA_TYPE: -32015;
+    readonly UNPROCESSABLE_CONTENT: -32022;
+    readonly TOO_MANY_REQUESTS: -32029;
+    readonly CLIENT_CLOSED_REQUEST: -32099;
+};
+interface RPCErrorContract {
+    procedure: string | undefined;
+    input: unknown | undefined;
+    issues: ZodIssue[] | undefined;
+    code: keyof typeof RPC_ERROR_CODE;
+    message: string;
+    stack?: string | undefined;
+    cause?: unknown;
+}
+
+type MockHandler<I, O> = (input: I) => Promise<O>;
+type ProcedureHandler<Context, I, O> = (options: {
+    ctx: Context;
+    input: I;
+}) => Promise<O>;
+type MiddlewareHandler<ContextIn, ContextOut> = (options: {
+    ctx: ContextIn;
+}) => Promise<ContextOut>;
+interface ProcedureMeta<I, O, _Context = unknown> {
+    readonly name: string;
+    readonly method: 'GET' | 'POST';
+    readonly inputSchema: Schema<I>;
+    readonly outputSchema: Schema<O>;
+}
+interface Procedure<I, O, _Context = unknown> extends ProcedureMeta<I, O, _Context> {
+    callable: {
+        call(context: unknown, input: I): Promise<O>;
+        try(context: unknown, input: I): ResultAsync<O, RPCErrorContract>;
+    };
+    readonly mocked: boolean;
+}
+type InferProcedureInput<P> = P extends Procedure<infer I, any, any> ? I : never;
+type InferProcedureOutput<P> = P extends Procedure<any, infer O, any> ? O : never;
+
+type RouterResponse<Data = unknown, Input = unknown> = {
+    result: {
+        data: Data;
+    };
+} | {
+    message: string;
+    code: number;
+    data: RouterErrorDetails<Input>;
+};
+type RouterErrorDetails<Input = unknown> = {
+    code: string;
+    httpStatus: number;
+    message: string;
+    procedure?: string;
+    issues?: ZodIssue[];
+    stack?: string;
+    input?: Input;
+};
+
+type Constructor<T> = new (...args: any[]) => T;
+type AbstractConstructor<T> = abstract new (...args: any[]) => T;
+type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+
+export { type AbstractConstructor, type Constructor, type InferProcedureInput, type InferProcedureOutput, JSON_RPC_ERROR_CODES_BY_KEY, type MiddlewareHandler, type MockHandler, type Prettify, type Procedure, type ProcedureHandler, type ProcedureMeta, type RPCErrorContract, RPC_ERROR_CODE, RPC_ERROR_KEY, type RouterErrorDetails, type RouterResponse };

package/dist/index.d.ts

@@ -0,0 +1,138 @@
+import { ZodIssue, Schema } from 'zod';
+import { ResultAsync } from 'neverthrow';
+
+declare const RPC_ERROR_CODE: {
+    readonly PARSE_ERROR: 400;
+    readonly BAD_REQUEST: 400;
+    readonly UNAUTHORIZED: 401;
+    readonly FORBIDDEN: 403;
+    readonly NOT_FOUND: 404;
+    readonly METHOD_NOT_SUPPORTED: 405;
+    readonly TIMEOUT: 408;
+    readonly CONFLICT: 409;
+    readonly PRECONDITION_FAILED: 412;
+    readonly PAYLOAD_TOO_LARGE: 413;
+    readonly UNSUPPORTED_MEDIA_TYPE: 415;
+    readonly UNPROCESSABLE_CONTENT: 422;
+    readonly TOO_MANY_REQUESTS: 429;
+    readonly CLIENT_CLOSED_REQUEST: 499;
+    readonly INTERNAL_SERVER_ERROR: 500;
+    readonly NOT_IMPLEMENTED: 501;
+    readonly BAD_GATEWAY: 502;
+    readonly SERVICE_UNAVAILABLE: 503;
+    readonly GATEWAY_TIMEOUT: 504;
+};
+declare const RPC_ERROR_KEY: {
+    readonly 400: "PARSE_ERROR";
+    readonly 401: "UNAUTHORIZED";
+    readonly 403: "FORBIDDEN";
+    readonly 404: "NOT_FOUND";
+    readonly 405: "METHOD_NOT_SUPPORTED";
+    readonly 408: "TIMEOUT";
+    readonly 409: "CONFLICT";
+    readonly 412: "PRECONDITION_FAILED";
+    readonly 413: "PAYLOAD_TOO_LARGE";
+    readonly 415: "UNSUPPORTED_MEDIA_TYPE";
+    readonly 422: "UNPROCESSABLE_CONTENT";
+    readonly 429: "TOO_MANY_REQUESTS";
+    readonly 499: "CLIENT_CLOSED_REQUEST";
+    readonly 500: "INTERNAL_SERVER_ERROR";
+    readonly 501: "NOT_IMPLEMENTED";
+    readonly 502: "BAD_GATEWAY";
+    readonly 503: "SERVICE_UNAVAILABLE";
+    readonly 504: "GATEWAY_TIMEOUT";
+};
+/**
+ * JSON-RPC 2.0 Error codes
+ *
+ * `-32000` to `-32099` are reserved for implementation-defined server-errors.
+ * For tRPC we're copying the last digits of HTTP 4XX errors.
+ */
+declare const JSON_RPC_ERROR_CODES_BY_KEY: {
+    /**
+     * Invalid JSON was received by the server.
+     * An error occurred on the server while parsing the JSON text.
+     */
+    readonly PARSE_ERROR: -32700;
+    /**
+     * The JSON sent is not a valid Request object.
+     */
+    readonly BAD_REQUEST: -32600;
+    readonly INTERNAL_SERVER_ERROR: -32603;
+    readonly NOT_IMPLEMENTED: -32603;
+    readonly BAD_GATEWAY: -32603;
+    readonly SERVICE_UNAVAILABLE: -32603;
+    readonly GATEWAY_TIMEOUT: -32603;
+    readonly UNAUTHORIZED: -32001;
+    readonly FORBIDDEN: -32003;
+    readonly NOT_FOUND: -32004;
+    readonly METHOD_NOT_SUPPORTED: -32005;
+    readonly TIMEOUT: -32008;
+    readonly CONFLICT: -32009;
+    readonly PRECONDITION_FAILED: -32012;
+    readonly PAYLOAD_TOO_LARGE: -32013;
+    readonly UNSUPPORTED_MEDIA_TYPE: -32015;
+    readonly UNPROCESSABLE_CONTENT: -32022;
+    readonly TOO_MANY_REQUESTS: -32029;
+    readonly CLIENT_CLOSED_REQUEST: -32099;
+};
+interface RPCErrorContract {
+    procedure: string | undefined;
+    input: unknown | undefined;
+    issues: ZodIssue[] | undefined;
+    code: keyof typeof RPC_ERROR_CODE;
+    message: string;
+    stack?: string | undefined;
+    cause?: unknown;
+}
+
+type MockHandler<I, O> = (input: I) => Promise<O>;
+type ProcedureHandler<Context, I, O> = (options: {
+    ctx: Context;
+    input: I;
+}) => Promise<O>;
+type MiddlewareHandler<ContextIn, ContextOut> = (options: {
+    ctx: ContextIn;
+}) => Promise<ContextOut>;
+interface ProcedureMeta<I, O, _Context = unknown> {
+    readonly name: string;
+    readonly method: 'GET' | 'POST';
+    readonly inputSchema: Schema<I>;
+    readonly outputSchema: Schema<O>;
+}
+interface Procedure<I, O, _Context = unknown> extends ProcedureMeta<I, O, _Context> {
+    callable: {
+        call(context: unknown, input: I): Promise<O>;
+        try(context: unknown, input: I): ResultAsync<O, RPCErrorContract>;
+    };
+    readonly mocked: boolean;
+}
+type InferProcedureInput<P> = P extends Procedure<infer I, any, any> ? I : never;
+type InferProcedureOutput<P> = P extends Procedure<any, infer O, any> ? O : never;
+
+type RouterResponse<Data = unknown, Input = unknown> = {
+    result: {
+        data: Data;
+    };
+} | {
+    message: string;
+    code: number;
+    data: RouterErrorDetails<Input>;
+};
+type RouterErrorDetails<Input = unknown> = {
+    code: string;
+    httpStatus: number;
+    message: string;
+    procedure?: string;
+    issues?: ZodIssue[];
+    stack?: string;
+    input?: Input;
+};
+
+type Constructor<T> = new (...args: any[]) => T;
+type AbstractConstructor<T> = abstract new (...args: any[]) => T;
+type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+
+export { type AbstractConstructor, type Constructor, type InferProcedureInput, type InferProcedureOutput, JSON_RPC_ERROR_CODES_BY_KEY, type MiddlewareHandler, type MockHandler, type Prettify, type Procedure, type ProcedureHandler, type ProcedureMeta, type RPCErrorContract, RPC_ERROR_CODE, RPC_ERROR_KEY, type RouterErrorDetails, type RouterResponse };

package/dist/index.js

@@ -0,0 +1,98 @@
+// src/error.ts
+var RPC_ERROR_CODE = {
+  PARSE_ERROR: 400,
+  BAD_REQUEST: 400,
+  UNAUTHORIZED: 401,
+  FORBIDDEN: 403,
+  NOT_FOUND: 404,
+  METHOD_NOT_SUPPORTED: 405,
+  TIMEOUT: 408,
+  CONFLICT: 409,
+  PRECONDITION_FAILED: 412,
+  PAYLOAD_TOO_LARGE: 413,
+  UNSUPPORTED_MEDIA_TYPE: 415,
+  UNPROCESSABLE_CONTENT: 422,
+  TOO_MANY_REQUESTS: 429,
+  CLIENT_CLOSED_REQUEST: 499,
+  INTERNAL_SERVER_ERROR: 500,
+  NOT_IMPLEMENTED: 501,
+  BAD_GATEWAY: 502,
+  SERVICE_UNAVAILABLE: 503,
+  GATEWAY_TIMEOUT: 504
+};
+var RPC_ERROR_KEY = {
+  400: "PARSE_ERROR",
+  401: "UNAUTHORIZED",
+  403: "FORBIDDEN",
+  404: "NOT_FOUND",
+  405: "METHOD_NOT_SUPPORTED",
+  408: "TIMEOUT",
+  409: "CONFLICT",
+  412: "PRECONDITION_FAILED",
+  413: "PAYLOAD_TOO_LARGE",
+  415: "UNSUPPORTED_MEDIA_TYPE",
+  422: "UNPROCESSABLE_CONTENT",
+  429: "TOO_MANY_REQUESTS",
+  499: "CLIENT_CLOSED_REQUEST",
+  500: "INTERNAL_SERVER_ERROR",
+  501: "NOT_IMPLEMENTED",
+  502: "BAD_GATEWAY",
+  503: "SERVICE_UNAVAILABLE",
+  504: "GATEWAY_TIMEOUT"
+};
+var JSON_RPC_ERROR_CODES_BY_KEY = {
+  /**
+   * Invalid JSON was received by the server.
+   * An error occurred on the server while parsing the JSON text.
+   */
+  PARSE_ERROR: -32700,
+  /**
+   * The JSON sent is not a valid Request object.
+   */
+  BAD_REQUEST: -32600,
+  // 400
+  // Internal JSON-RPC error
+  INTERNAL_SERVER_ERROR: -32603,
+  // 500
+  NOT_IMPLEMENTED: -32603,
+  // 501
+  BAD_GATEWAY: -32603,
+  // 502
+  SERVICE_UNAVAILABLE: -32603,
+  // 503
+  GATEWAY_TIMEOUT: -32603,
+  // 504
+  // Implementation specific errors
+  UNAUTHORIZED: -32001,
+  // 401
+  FORBIDDEN: -32003,
+  // 403
+  NOT_FOUND: -32004,
+  // 404
+  METHOD_NOT_SUPPORTED: -32005,
+  // 405
+  TIMEOUT: -32008,
+  // 408
+  CONFLICT: -32009,
+  // 409
+  PRECONDITION_FAILED: -32012,
+  // 412
+  PAYLOAD_TOO_LARGE: -32013,
+  // 413
+  UNSUPPORTED_MEDIA_TYPE: -32015,
+  // 415
+  UNPROCESSABLE_CONTENT: -32022,
+  // 422
+  TOO_MANY_REQUESTS: -32029,
+  // 429
+  CLIENT_CLOSED_REQUEST: -32099
+  // 499
+};
+
+// src/router/types.ts
+import "zod";
+export {
+  JSON_RPC_ERROR_CODES_BY_KEY,
+  RPC_ERROR_CODE,
+  RPC_ERROR_KEY
+};

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@pl4dr/rpc-core",
+  "version": "1001.0.0",
+  "description": "RPC Core",
+  "author": "Chan Nyein Thaw<me@chanyeinthaw.com>",
+  "type": "module",
+  "main": "dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pl4dr/rpc"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "import": "./dist/index.js",
+      "default": "./dist/index.cjs"
+    }
+  },
+  "devDependencies": {
+    "typescript": "*"
+  },
+  "dependencies": {
+    "neverthrow": "*",
+    "superjson": "*",
+    "zod": "*"
+  },
+  "scripts": {
+    "lint": "tsc",
+    "build": "tsup",
+    "format": "prettier --write .",
+    "check:format": "prettier --check .",
+    "check:exports": "attw --pack . --ignore-rules=cjs-resolves-to-esm"
+  }
+}