@kibinrpc/server 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ixexel661
+
+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.d.mts

@@ -0,0 +1,37 @@
+//#region src/decorator.d.ts
+declare function ServerAction(): <This, Args extends unknown[], Return>(target: (this: This, ...args: Args) => Return, context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Return>) => (this: This, ...args: Args) => Return;
+//#endregion
+//#region src/errors.d.ts
+declare class KibinError extends Error {
+  readonly code: string;
+  readonly statusCode: number;
+  constructor(code: string, message: string, statusCode?: number);
+}
+//#endregion
+//#region src/fn.d.ts
+declare function serverAction<T extends (...args: never[]) => unknown>(fn: T): T;
+declare function defineActions<T extends Record<string, (...args: never[]) => unknown>>(actions: T): T;
+//#endregion
+//#region src/router.d.ts
+type Services = Record<string, object>;
+declare function createRouter<T extends Services>(services: T): {
+  services: T;
+  handler: (request: Request) => Promise<Response>;
+};
+//#endregion
+//#region src/types.d.ts
+interface RpcRequest {
+  namespace: string;
+  method: string;
+  args: unknown[];
+}
+interface RpcResponse<T = unknown> {
+  data?: T;
+  error?: {
+    code: string;
+    message: string;
+  };
+}
+//#endregion
+export { KibinError, type RpcRequest, type RpcResponse, ServerAction, createRouter, defineActions, serverAction };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/decorator.ts","../src/errors.ts","../src/fn.ts","../src/router.ts","../src/types.ts"],"mappings":";iBAEgB,YAAA,CAAA,0CAEd,MAAA,GAAS,IAAA,EAAM,IAAA,KAAS,IAAA,EAAM,IAAA,KAAS,MAAA,EACvC,OAAA,EAAS,2BAAA,CAA4B,IAAA,GAAO,IAAA,EAAM,IAAA,KAAS,IAAA,EAAM,IAAA,KAAS,MAAA,OAAO,IAAA,EADlE,IAAA,KAAI,IAAA,EAAW,IAAA,KAAS,MAAA;;;cCJ5B,UAAA,SAAmB,KAAK;EAAA,SAC3B,IAAA;EAAA,SACA,UAAA;cAEG,IAAA,UAAc,OAAA,UAAiB,UAAA;AAAA;;;iBCF5B,YAAA,eAA2B,IAAA,sBAAA,CAA2B,EAAA,EAAI,CAAA,GAAI,CAAC;AAAA,iBAK/D,aAAA,WAAwB,MAAA,aAAmB,IAAA,uBAAA,CAC1D,OAAA,EAAS,CAAA,GACP,CAAA;;;KCLE,QAAA,GAAW,MAAM;AAAA,iBASN,YAAA,WAAuB,QAAA,CAAA,CAAU,QAAA,EAAU,CAAA;;qBAC1B,OAAA,KAAU,OAAA,CAAQ,QAAA;AAAA;;;UCdlC,UAAA;EAChB,SAAA;EACA,MAAA;EACA,IAAA;AAAA;AAAA,UAGgB,WAAA;EAChB,IAAA,GAAO,CAAC;EACR,KAAA;IAAU,IAAA;IAAc,OAAA;EAAA;AAAA"}

package/dist/index.mjs

@@ -0,0 +1,98 @@
+//#region src/registry.ts
+const SERVER_ACTIONS_KEY = Symbol("serverActions");
+const FUNCTION_ACTION_KEY = Symbol("functionAction");
+function getRegisteredActions(instance) {
+	return Reflect.get(instance, SERVER_ACTIONS_KEY) ?? /* @__PURE__ */ new Set();
+}
+function isBrandedAction(fn) {
+	return typeof fn === "function" && Reflect.get(fn, FUNCTION_ACTION_KEY) === true;
+}
+//#endregion
+//#region src/decorator.ts
+function ServerAction() {
+	return (target, context) => {
+		context.addInitializer(function() {
+			if (!Reflect.has(this, SERVER_ACTIONS_KEY)) Reflect.set(this, SERVER_ACTIONS_KEY, /* @__PURE__ */ new Set());
+			Reflect.get(this, SERVER_ACTIONS_KEY).add(String(context.name));
+		});
+		return target;
+	};
+}
+//#endregion
+//#region src/errors.ts
+var KibinError = class extends Error {
+	code;
+	statusCode;
+	constructor(code, message, statusCode = 400) {
+		super(message);
+		this.name = "KibinError";
+		this.code = code;
+		this.statusCode = statusCode;
+	}
+};
+//#endregion
+//#region src/fn.ts
+function serverAction(fn) {
+	Reflect.set(fn, FUNCTION_ACTION_KEY, true);
+	return fn;
+}
+function defineActions(actions) {
+	for (const key of Object.keys(actions)) serverAction(actions[key]);
+	return actions;
+}
+//#endregion
+//#region src/router.ts
+function jsonResponse(body, status) {
+	return new Response(JSON.stringify(body), {
+		status,
+		headers: { "Content-Type": "application/json" }
+	});
+}
+function createRouter(services) {
+	async function handler(request) {
+		let body;
+		try {
+			body = await request.json();
+		} catch {
+			return jsonResponse({ error: {
+				code: "BAD_REQUEST",
+				message: "Invalid JSON body"
+			} }, 400);
+		}
+		const { namespace, method, args } = body;
+		const service = services[namespace];
+		if (!service) return jsonResponse({ error: {
+			code: "NOT_FOUND",
+			message: `Namespace "${namespace}" not found`
+		} }, 404);
+		const fn = service[method];
+		if (!(getRegisteredActions(service).has(method) || isBrandedAction(fn))) return jsonResponse({ error: {
+			code: "METHOD_NOT_FOUND",
+			message: `"${method}" is not a registered server action`
+		} }, 404);
+		if (typeof fn !== "function") return jsonResponse({ error: {
+			code: "METHOD_NOT_FOUND",
+			message: `Method "${method}" not found`
+		} }, 404);
+		try {
+			return jsonResponse({ data: await fn.apply(service, args) }, 200);
+		} catch (error) {
+			if (error instanceof KibinError) return jsonResponse({ error: {
+				code: error.code,
+				message: error.message
+			} }, error.statusCode);
+			return jsonResponse({ error: {
+				code: "INTERNAL_ERROR",
+				message: "Internal server error"
+			} }, 500);
+		}
+	}
+	return {
+		services,
+		handler
+	};
+}
+//#endregion
+export { KibinError, ServerAction, createRouter, defineActions, serverAction };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/registry.ts","../src/decorator.ts","../src/errors.ts","../src/fn.ts","../src/router.ts"],"sourcesContent":["export const SERVER_ACTIONS_KEY = Symbol('serverActions');\nexport const FUNCTION_ACTION_KEY = Symbol('functionAction');\n\nexport function getRegisteredActions(instance: object): Set<string> {\n\treturn (Reflect.get(instance, SERVER_ACTIONS_KEY) as Set<string> | undefined) ?? new Set();\n}\n\nexport function isBrandedAction(fn: unknown): boolean {\n\treturn typeof fn === 'function' && Reflect.get(fn, FUNCTION_ACTION_KEY) === true;\n}\n","import { SERVER_ACTIONS_KEY } from './registry.js';\n\nexport function ServerAction() {\n\treturn <This, Args extends unknown[], Return>(\n\t\ttarget: (this: This, ...args: Args) => Return,\n\t\tcontext: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Return>,\n\t) => {\n\t\tcontext.addInitializer(function (this: This) {\n\t\t\tif (!Reflect.has(this as object, SERVER_ACTIONS_KEY)) {\n\t\t\t\tReflect.set(this as object, SERVER_ACTIONS_KEY, new Set<string>());\n\t\t\t}\n\t\t\t(Reflect.get(this as object, SERVER_ACTIONS_KEY) as Set<string>).add(String(context.name));\n\t\t});\n\t\treturn target;\n\t};\n}\n","export class KibinError extends Error {\n\treadonly code: string;\n\treadonly statusCode: number;\n\n\tconstructor(code: string, message: string, statusCode = 400) {\n\t\tsuper(message);\n\t\tthis.name = 'KibinError';\n\t\tthis.code = code;\n\t\tthis.statusCode = statusCode;\n\t}\n}\n","import { FUNCTION_ACTION_KEY } from './registry.js';\n\nexport function serverAction<T extends (...args: never[]) => unknown>(fn: T): T {\n\tReflect.set(fn, FUNCTION_ACTION_KEY, true);\n\treturn fn;\n}\n\nexport function defineActions<T extends Record<string, (...args: never[]) => unknown>>(\n\tactions: T,\n): T {\n\tfor (const key of Object.keys(actions)) {\n\t\tserverAction(actions[key]);\n\t}\n\treturn actions;\n}\n","import { KibinError } from './errors.js';\nimport { getRegisteredActions, isBrandedAction } from './registry.js';\nimport type { RpcRequest, RpcResponse } from './types.js';\n\ntype Services = Record<string, object>;\n\nfunction jsonResponse(body: RpcResponse, status: number): Response {\n\treturn new Response(JSON.stringify(body), {\n\t\tstatus,\n\t\theaders: { 'Content-Type': 'application/json' },\n\t});\n}\n\nexport function createRouter<T extends Services>(services: T) {\n\tasync function handler(request: Request): Promise<Response> {\n\t\tlet body: RpcRequest;\n\t\ttry {\n\t\t\tbody = (await request.json()) as RpcRequest;\n\t\t} catch {\n\t\t\treturn jsonResponse({ error: { code: 'BAD_REQUEST', message: 'Invalid JSON body' } }, 400);\n\t\t}\n\n\t\tconst { namespace, method, args } = body;\n\n\t\tconst service = services[namespace];\n\t\tif (!service) {\n\t\t\treturn jsonResponse(\n\t\t\t\t{ error: { code: 'NOT_FOUND', message: `Namespace \"${namespace}\" not found` } },\n\t\t\t\t404,\n\t\t\t);\n\t\t}\n\n\t\tconst fn = (service as Record<string, unknown>)[method];\n\t\tconst isAllowed = getRegisteredActions(service).has(method) || isBrandedAction(fn);\n\t\tif (!isAllowed) {\n\t\t\treturn jsonResponse(\n\t\t\t\t{\n\t\t\t\t\terror: {\n\t\t\t\t\t\tcode: 'METHOD_NOT_FOUND',\n\t\t\t\t\t\tmessage: `\"${method}\" is not a registered server action`,\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t404,\n\t\t\t);\n\t\t}\n\n\t\tif (typeof fn !== 'function') {\n\t\t\treturn jsonResponse(\n\t\t\t\t{ error: { code: 'METHOD_NOT_FOUND', message: `Method \"${method}\" not found` } },\n\t\t\t\t404,\n\t\t\t);\n\t\t}\n\n\t\ttry {\n\t\t\tconst result = await fn.apply(service, args);\n\t\t\treturn jsonResponse({ data: result }, 200);\n\t\t} catch (error) {\n\t\t\tif (error instanceof KibinError) {\n\t\t\t\treturn jsonResponse(\n\t\t\t\t\t{ error: { code: error.code, message: error.message } },\n\t\t\t\t\terror.statusCode,\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn jsonResponse(\n\t\t\t\t{ error: { code: 'INTERNAL_ERROR', message: 'Internal server error' } },\n\t\t\t\t500,\n\t\t\t);\n\t\t}\n\t}\n\n\treturn { services, handler };\n}\n"],"mappings":";AAAA,MAAa,qBAAqB,OAAO,eAAe;AACxD,MAAa,sBAAsB,OAAO,gBAAgB;AAE1D,SAAgB,qBAAqB,UAA+B;CACnE,OAAQ,QAAQ,IAAI,UAAU,kBAAkB,qBAAiC,IAAI,IAAI;AAC1F;AAEA,SAAgB,gBAAgB,IAAsB;CACrD,OAAO,OAAO,OAAO,cAAc,QAAQ,IAAI,IAAI,mBAAmB,MAAM;AAC7E;;;ACPA,SAAgB,eAAe;CAC9B,QACC,QACA,YACI;EACJ,QAAQ,eAAe,WAAsB;GAC5C,IAAI,CAAC,QAAQ,IAAI,MAAgB,kBAAkB,GAClD,QAAQ,IAAI,MAAgB,oCAAoB,IAAI,IAAY,CAAC;GAElE,QAAS,IAAI,MAAgB,kBAAkB,EAAkB,IAAI,OAAO,QAAQ,IAAI,CAAC;EAC1F,CAAC;EACD,OAAO;CACR;AACD;;;ACfA,IAAa,aAAb,cAAgC,MAAM;CACrC;CACA;CAEA,YAAY,MAAc,SAAiB,aAAa,KAAK;EAC5D,MAAM,OAAO;EACb,KAAK,OAAO;EACZ,KAAK,OAAO;EACZ,KAAK,aAAa;CACnB;AACD;;;ACRA,SAAgB,aAAsD,IAAU;CAC/E,QAAQ,IAAI,IAAI,qBAAqB,IAAI;CACzC,OAAO;AACR;AAEA,SAAgB,cACf,SACI;CACJ,KAAK,MAAM,OAAO,OAAO,KAAK,OAAO,GACpC,aAAa,QAAQ,IAAI;CAE1B,OAAO;AACR;;;ACRA,SAAS,aAAa,MAAmB,QAA0B;CAClE,OAAO,IAAI,SAAS,KAAK,UAAU,IAAI,GAAG;EACzC;EACA,SAAS,EAAE,gBAAgB,mBAAmB;CAC/C,CAAC;AACF;AAEA,SAAgB,aAAiC,UAAa;CAC7D,eAAe,QAAQ,SAAqC;EAC3D,IAAI;EACJ,IAAI;GACH,OAAQ,MAAM,QAAQ,KAAK;EAC5B,QAAQ;GACP,OAAO,aAAa,EAAE,OAAO;IAAE,MAAM;IAAe,SAAS;GAAoB,EAAE,GAAG,GAAG;EAC1F;EAEA,MAAM,EAAE,WAAW,QAAQ,SAAS;EAEpC,MAAM,UAAU,SAAS;EACzB,IAAI,CAAC,SACJ,OAAO,aACN,EAAE,OAAO;GAAE,MAAM;GAAa,SAAS,cAAc,UAAU;EAAa,EAAE,GAC9E,GACD;EAGD,MAAM,KAAM,QAAoC;EAEhD,IAAI,EADc,qBAAqB,OAAO,EAAE,IAAI,MAAM,KAAK,gBAAgB,EAAE,IAEhF,OAAO,aACN,EACC,OAAO;GACN,MAAM;GACN,SAAS,IAAI,OAAO;EACrB,EACD,GACA,GACD;EAGD,IAAI,OAAO,OAAO,YACjB,OAAO,aACN,EAAE,OAAO;GAAE,MAAM;GAAoB,SAAS,WAAW,OAAO;EAAa,EAAE,GAC/E,GACD;EAGD,IAAI;GAEH,OAAO,aAAa,EAAE,MAAM,MADP,GAAG,MAAM,SAAS,IAAI,EACR,GAAG,GAAG;EAC1C,SAAS,OAAO;GACf,IAAI,iBAAiB,YACpB,OAAO,aACN,EAAE,OAAO;IAAE,MAAM,MAAM;IAAM,SAAS,MAAM;GAAQ,EAAE,GACtD,MAAM,UACP;GAED,OAAO,aACN,EAAE,OAAO;IAAE,MAAM;IAAkB,SAAS;GAAwB,EAAE,GACtE,GACD;EACD;CACD;CAEA,OAAO;EAAE;EAAU;CAAQ;AAC5B"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@kibinrpc/server",
+  "version": "0.0.2",
+  "description": "Devloper-friendly RPC server router with full type inference",
+  "license": "MIT",
+  "author": "ixexel661",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ixexel661/kibin",
+    "directory": "packages/server"
+  },
+  "keywords": [
+    "rpc",
+    "server",
+    "typescript",
+    "web-api",
+    "api",
+    "backend"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.mts"
+    }
+  },
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch"
+  }
+}