@kibinrpc/server 0.0.2 → 0.0.4

package/README.md

@@ -0,0 +1,161 @@
+# @kibinrpc/server
+
+Server router for [kibinrpc](../../README.md) — register actions, mount a single handler.
+
+## Installation
+
+```sh
+npm install @kibinrpc/server
+```
+
+## Quick start
+
+```ts
+import { ServerAction, defineActions, createRouter, KibinError } from '@kibinrpc/server'
+
+class UserActions {
+  @ServerAction()
+  async getUser(id: string) {
+    const user = await db.users.find(id)
+    if (!user) throw new KibinError('NOT_FOUND', 'User not found')
+    return user
+  }
+}
+
+const postActions = defineActions({
+  async listPosts() {
+    return db.posts.findAll()
+  },
+})
+
+export const router = createRouter({
+  user: new UserActions(),
+  post: postActions,
+})
+
+export type AppRouter = typeof router
+```
+
+Mount on any framework that supports the Web `Request`/`Response` API:
+
+```ts
+// Hono
+app.post('/api/rpc', (c) => router.handler(c.req.raw))
+
+// Next.js App Router
+export const POST = router.handler
+```
+
+The handler automatically detects single vs. batched requests — no second endpoint needed.
+
+## Registering actions
+
+Only explicitly registered functions are callable. Everything else is rejected with `METHOD_NOT_FOUND`.
+
+### Class decorator
+
+```ts
+import { ServerAction } from '@kibinrpc/server'
+
+class UserActions {
+  @ServerAction()
+  async listUsers() { ... }
+
+  // Not callable from the client — not decorated
+  private helper() { ... }
+}
+```
+
+### Functional
+
+```ts
+import { defineActions, serverAction } from '@kibinrpc/server'
+
+// Register a whole namespace at once
+const postActions = defineActions({
+  async listPosts() { ... },
+  async createPost(data: NewPost) { ... },
+})
+
+// Or mark individual functions
+const deletePost = serverAction(async (id: string) => { ... })
+```
+
+## Interceptors
+
+Interceptors run for every call — including each item inside a batched request.
+
+```ts
+const router = createRouter({ user, post }, {
+  beforeAction({ namespace, method, args, request }) {
+    const token = request.headers.get('Authorization')
+    if (!token) throw new KibinError('UNAUTHORIZED', 'Missing token')
+  },
+
+  afterAction({ namespace, method, result }) {
+    return result // optionally transform the result
+  },
+
+  onError({ namespace, method, error }) {
+    console.error(`[RPC] ${namespace}.${method} failed`, error)
+  },
+})
+```
+
+## Error handling
+
+Throw `KibinError` to send a structured error to the client:
+
+```ts
+import { KibinError } from '@kibinrpc/server'
+
+throw new KibinError('NOT_FOUND', 'User not found')
+throw new KibinError('UNAUTHORIZED', 'Invalid token')
+throw new KibinError('BAD_REQUEST', 'Invalid input')
+```
+
+Any other thrown error becomes `{ code: 'INTERNAL_ERROR' }` — the original message is not leaked.
+
+## HTTP status codes
+
+| Error code | HTTP status |
+|---|---|
+| `NOT_FOUND`, `METHOD_NOT_FOUND` | 404 |
+| `BAD_REQUEST` | 400 |
+| everything else | 500 |
+
+For batched requests, each item carries its own `status` field. The overall HTTP status is `200` if all items succeed, `207 Multi-Status` for partial failures.
+
+## API
+
+### `createRouter(services, interceptors?)`
+
+```ts
+const router = createRouter(
+  { user: new UserActions(), post: postActions },
+  { beforeAction, afterAction, onError },
+)
+
+router.handler // (request: Request) => Promise<Response>
+router.services // the original services object
+```
+
+### `KibinError`
+
+```ts
+new KibinError(code: string, message: string)
+```
+
+### Exported types
+
+```ts
+import type {
+  RouterInterceptors,
+  ActionCtx,
+  AfterActionCtx,
+  ActionErrorCtx,
+  RpcRequest,
+  RpcResponse,
+  RpcBatchItemResponse,
+} from '@kibinrpc/server'
+```

package/dist/index.d.mts

@@ -12,13 +12,6 @@ declare class KibinError extends Error {
 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;
@@ -32,6 +25,33 @@ interface RpcResponse<T = unknown> {
     message: string;
   };
 }
+interface RpcBatchItemResponse extends RpcResponse {
+  status: number;
+}
+interface ActionCtx {
+  namespace: string;
+  method: string;
+  args: unknown[];
+  request: Request;
+}
+interface AfterActionCtx extends ActionCtx {
+  result: unknown;
+}
+interface ActionErrorCtx extends ActionCtx {
+  error: unknown;
+}
+interface RouterInterceptors {
+  beforeAction?: (ctx: ActionCtx) => void | Promise<void>;
+  afterAction?: (ctx: AfterActionCtx) => unknown | Promise<unknown>;
+  onError?: (ctx: ActionErrorCtx) => void | Promise<void>;
+}
+//#endregion
+//#region src/router.d.ts
+type Services = Record<string, object>;
+declare function createRouter<T extends Services>(services: T, interceptors?: RouterInterceptors): {
+  services: T;
+  handler: (request: Request) => Promise<Response>;
+};
 //#endregion
-export { KibinError, type RpcRequest, type RpcResponse, ServerAction, createRouter, defineActions, serverAction };
+export { type ActionCtx, type ActionErrorCtx, type AfterActionCtx, KibinError, type RouterInterceptors, type RpcBatchItemResponse, type RpcRequest, type RpcResponse, ServerAction, createRouter, defineActions, serverAction };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/decorator.ts","../src/errors.ts","../src/fn.ts","../src/types.ts","../src/router.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;;;UCTc,UAAA;EAChB,SAAA;EACA,MAAA;EACA,IAAA;AAAA;AAAA,UAGgB,WAAA;EAChB,IAAA,GAAO,CAAC;EACR,KAAA;IAAU,IAAA;IAAc,OAAA;EAAA;AAAA;AAAA,UAGR,oBAAA,SAA6B,WAAW;EACxD,MAAM;AAAA;AAAA,UAGU,SAAA;EAChB,SAAA;EACA,MAAA;EACA,IAAA;EACA,OAAA,EAAS,OAAO;AAAA;AAAA,UAGA,cAAA,SAAuB,SAAS;EAChD,MAAM;AAAA;AAAA,UAGU,cAAA,SAAuB,SAAS;EAChD,KAAK;AAAA;AAAA,UAGW,kBAAA;EAChB,YAAA,IAAgB,GAAA,EAAK,SAAA,YAAqB,OAAA;EAC1C,WAAA,IAAe,GAAA,EAAK,cAAA,eAA6B,OAAA;EACjD,OAAA,IAAW,GAAA,EAAK,cAAA,YAA0B,OAAA;AAAA;;;KC7BtC,QAAA,GAAW,MAAM;AAAA,iBAwEN,YAAA,WAAuB,QAAA,CAAA,CAAU,QAAA,EAAU,CAAA,EAAG,YAAA,GAAe,kBAAA;;qBAC5C,OAAA,KAAU,OAAA,CAAQ,QAAA;AAAA"}

package/dist/index.mjs

@@ -48,7 +48,62 @@ function jsonResponse(body, status) {
 		headers: { "Content-Type": "application/json" }
 	});
 }
-function createRouter(services) {
+function statusFromResponse(result) {
+	if (!result.error) return 200;
+	if (result.error.code === "NOT_FOUND" || result.error.code === "METHOD_NOT_FOUND") return 404;
+	if (result.error.code === "BAD_REQUEST") return 400;
+	return 500;
+}
+async function executeRpcCall(body, request, services, interceptors) {
+	const { namespace, method, args } = body;
+	const service = services[namespace];
+	if (!service) return { error: {
+		code: "NOT_FOUND",
+		message: `Namespace "${namespace}" not found`
+	} };
+	const fn = service[method];
+	if (!(getRegisteredActions(service).has(method) || isBrandedAction(fn))) return { error: {
+		code: "METHOD_NOT_FOUND",
+		message: `"${method}" is not a registered server action`
+	} };
+	if (typeof fn !== "function") return { error: {
+		code: "METHOD_NOT_FOUND",
+		message: `Method "${method}" not found`
+	} };
+	const ctx = {
+		namespace,
+		method,
+		args,
+		request
+	};
+	try {
+		if (interceptors?.beforeAction) await interceptors.beforeAction(ctx);
+		const result = await fn.apply(service, args);
+		let finalResult = result;
+		if (interceptors?.afterAction) {
+			const transformed = await interceptors.afterAction({
+				...ctx,
+				result
+			});
+			if (transformed !== void 0) finalResult = transformed;
+		}
+		return { data: finalResult };
+	} catch (error) {
+		if (interceptors?.onError) await interceptors.onError({
+			...ctx,
+			error
+		});
+		if (error instanceof KibinError) return { error: {
+			code: error.code,
+			message: error.message
+		} };
+		return { error: {
+			code: "INTERNAL_ERROR",
+			message: "Internal server error"
+		} };
+	}
+}
+function createRouter(services, interceptors) {
 	async function handler(request) {
 		let body;
 		try {
@@ -59,33 +114,15 @@ function createRouter(services) {
 				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);
+		if (Array.isArray(body)) {
+			const responses = (await Promise.all(body.map((b) => executeRpcCall(b, request, services, interceptors)))).map((r) => ({
+				...r,
+				status: statusFromResponse(r)
+			}));
+			return jsonResponse(responses, responses.every((r) => r.status === 200) ? 200 : 207);
 		}
+		const result = await executeRpcCall(body, request, services, interceptors);
+		return jsonResponse(result, statusFromResponse(result));
 	}
 	return {
 		services,

package/dist/index.mjs.map

@@ -1 +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"}
+{"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 { RouterInterceptors, RpcBatchItemResponse, RpcRequest, RpcResponse } from './types.js';\n\ntype Services = Record<string, object>;\n\nfunction jsonResponse(body: RpcResponse | RpcBatchItemResponse[], status: number): Response {\n\treturn new Response(JSON.stringify(body), {\n\t\tstatus,\n\t\theaders: { 'Content-Type': 'application/json' },\n\t});\n}\n\nfunction statusFromResponse(result: RpcResponse): number {\n\tif (!result.error) return 200;\n\tif (result.error.code === 'NOT_FOUND' || result.error.code === 'METHOD_NOT_FOUND') return 404;\n\tif (result.error.code === 'BAD_REQUEST') return 400;\n\treturn 500;\n}\n\nasync function executeRpcCall(\n\tbody: RpcRequest,\n\trequest: Request,\n\tservices: Services,\n\tinterceptors: RouterInterceptors | undefined,\n): Promise<RpcResponse> {\n\tconst { namespace, method, args } = body;\n\n\tconst service = services[namespace];\n\tif (!service) {\n\t\treturn { error: { code: 'NOT_FOUND', message: `Namespace \"${namespace}\" not found` } };\n\t}\n\n\tconst fn = (service as Record<string, unknown>)[method];\n\tconst isAllowed = getRegisteredActions(service).has(method) || isBrandedAction(fn);\n\tif (!isAllowed) {\n\t\treturn {\n\t\t\terror: {\n\t\t\t\tcode: 'METHOD_NOT_FOUND',\n\t\t\t\tmessage: `\"${method}\" is not a registered server action`,\n\t\t\t},\n\t\t};\n\t}\n\n\tif (typeof fn !== 'function') {\n\t\treturn { error: { code: 'METHOD_NOT_FOUND', message: `Method \"${method}\" not found` } };\n\t}\n\n\tconst ctx = { namespace, method, args, request };\n\n\ttry {\n\t\tif (interceptors?.beforeAction) {\n\t\t\tawait interceptors.beforeAction(ctx);\n\t\t}\n\n\t\tconst result = await fn.apply(service, args);\n\n\t\tlet finalResult = result;\n\t\tif (interceptors?.afterAction) {\n\t\t\tconst transformed = await interceptors.afterAction({ ...ctx, result });\n\t\t\tif (transformed !== undefined) finalResult = transformed;\n\t\t}\n\n\t\treturn { data: finalResult };\n\t} catch (error) {\n\t\tif (interceptors?.onError) {\n\t\t\tawait interceptors.onError({ ...ctx, error });\n\t\t}\n\n\t\tif (error instanceof KibinError) {\n\t\t\treturn { error: { code: error.code, message: error.message } };\n\t\t}\n\t\treturn { error: { code: 'INTERNAL_ERROR', message: 'Internal server error' } };\n\t}\n}\n\nexport function createRouter<T extends Services>(services: T, interceptors?: RouterInterceptors) {\n\tasync function handler(request: Request): Promise<Response> {\n\t\tlet body: RpcRequest | RpcRequest[];\n\t\ttry {\n\t\t\tbody = (await request.json()) as RpcRequest | 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\tif (Array.isArray(body)) {\n\t\t\tconst results = await Promise.all(\n\t\t\t\tbody.map((b) => executeRpcCall(b, request, services, interceptors)),\n\t\t\t);\n\t\t\tconst responses: RpcBatchItemResponse[] = results.map((r) => ({\n\t\t\t\t...r,\n\t\t\t\tstatus: statusFromResponse(r),\n\t\t\t}));\n\t\t\tconst httpStatus = responses.every((r) => r.status === 200) ? 200 : 207;\n\t\t\treturn jsonResponse(responses, httpStatus);\n\t\t}\n\n\t\tconst result = await executeRpcCall(body, request, services, interceptors);\n\t\treturn jsonResponse(result, statusFromResponse(result));\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,MAA4C,QAA0B;CAC3F,OAAO,IAAI,SAAS,KAAK,UAAU,IAAI,GAAG;EACzC;EACA,SAAS,EAAE,gBAAgB,mBAAmB;CAC/C,CAAC;AACF;AAEA,SAAS,mBAAmB,QAA6B;CACxD,IAAI,CAAC,OAAO,OAAO,OAAO;CAC1B,IAAI,OAAO,MAAM,SAAS,eAAe,OAAO,MAAM,SAAS,oBAAoB,OAAO;CAC1F,IAAI,OAAO,MAAM,SAAS,eAAe,OAAO;CAChD,OAAO;AACR;AAEA,eAAe,eACd,MACA,SACA,UACA,cACuB;CACvB,MAAM,EAAE,WAAW,QAAQ,SAAS;CAEpC,MAAM,UAAU,SAAS;CACzB,IAAI,CAAC,SACJ,OAAO,EAAE,OAAO;EAAE,MAAM;EAAa,SAAS,cAAc,UAAU;CAAa,EAAE;CAGtF,MAAM,KAAM,QAAoC;CAEhD,IAAI,EADc,qBAAqB,OAAO,EAAE,IAAI,MAAM,KAAK,gBAAgB,EAAE,IAEhF,OAAO,EACN,OAAO;EACN,MAAM;EACN,SAAS,IAAI,OAAO;CACrB,EACD;CAGD,IAAI,OAAO,OAAO,YACjB,OAAO,EAAE,OAAO;EAAE,MAAM;EAAoB,SAAS,WAAW,OAAO;CAAa,EAAE;CAGvF,MAAM,MAAM;EAAE;EAAW;EAAQ;EAAM;CAAQ;CAE/C,IAAI;EACH,IAAI,cAAc,cACjB,MAAM,aAAa,aAAa,GAAG;EAGpC,MAAM,SAAS,MAAM,GAAG,MAAM,SAAS,IAAI;EAE3C,IAAI,cAAc;EAClB,IAAI,cAAc,aAAa;GAC9B,MAAM,cAAc,MAAM,aAAa,YAAY;IAAE,GAAG;IAAK;GAAO,CAAC;GACrE,IAAI,gBAAgB,KAAA,GAAW,cAAc;EAC9C;EAEA,OAAO,EAAE,MAAM,YAAY;CAC5B,SAAS,OAAO;EACf,IAAI,cAAc,SACjB,MAAM,aAAa,QAAQ;GAAE,GAAG;GAAK;EAAM,CAAC;EAG7C,IAAI,iBAAiB,YACpB,OAAO,EAAE,OAAO;GAAE,MAAM,MAAM;GAAM,SAAS,MAAM;EAAQ,EAAE;EAE9D,OAAO,EAAE,OAAO;GAAE,MAAM;GAAkB,SAAS;EAAwB,EAAE;CAC9E;AACD;AAEA,SAAgB,aAAiC,UAAa,cAAmC;CAChG,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,IAAI,MAAM,QAAQ,IAAI,GAAG;GAIxB,MAAM,aAAoC,MAHpB,QAAQ,IAC7B,KAAK,KAAK,MAAM,eAAe,GAAG,SAAS,UAAU,YAAY,CAAC,CACnE,GACkD,KAAK,OAAO;IAC7D,GAAG;IACH,QAAQ,mBAAmB,CAAC;GAC7B,EAAE;GAEF,OAAO,aAAa,WADD,UAAU,OAAO,MAAM,EAAE,WAAW,GAAG,IAAI,MAAM,GAC3B;EAC1C;EAEA,MAAM,SAAS,MAAM,eAAe,MAAM,SAAS,UAAU,YAAY;EACzE,OAAO,aAAa,QAAQ,mBAAmB,MAAM,CAAC;CACvD;CAEA,OAAO;EAAE;EAAU;CAAQ;AAC5B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kibinrpc/server",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Devloper-friendly RPC server router with full type inference",
   "license": "MIT",
   "author": "ixexel661",