@open-core/framework 1.0.5 → 1.0.6

package/README.md

@@ -6,9 +6,9 @@
 [![website](https://img.shields.io/badge/web-opencorejs.dev-black?style=flat-square)](https://opencorejs.dev)
 
 
-# OpenCore Framework - Open Stable beta
+# OpenCore Framework - Stable v1
 
-OpenCore is a TypeScript multiplayer runtime framework targeting CitizenFX runtimes (Cfx) via adapters.
+OpenCore is a TypeScript multiplayer runtime framework targeting CitizenFX runtimes (Cfx/RageMP) via adapters.
 
 It is not a gamemode or RP framework. It provides:
 
@@ -277,12 +277,6 @@ pnpm lint:fix
 pnpm format
 ```
 
-## Ecosystem
-
-OpenCore is designed to be extended via separate packages/resources.
-
-- `@open-core/identity`: identity and permission system
-
 ## License
 
 MPL-2.0. See `LICENSE`.

package/dist/adapters/contracts/transport/index.d.ts

@@ -1,4 +1,5 @@
 export * from './context';
 export * from './events.api';
 export * from './rpc.api';
+export * from './rpc-error';
 export * from './messaging.transport';

package/dist/adapters/contracts/transport/index.js

@@ -1,4 +1,5 @@
 export * from './context';
 export * from './events.api';
 export * from './rpc.api';
+export * from './rpc-error';
 export * from './messaging.transport';

package/dist/adapters/contracts/transport/rpc-error.d.ts

@@ -0,0 +1,17 @@
+export declare const PUBLIC_RPC_ERROR_MESSAGE = "An internal server error occurred";
+export type RpcErrorInfo = {
+    message: string;
+    name?: string;
+};
+type ExposedRpcError = {
+    message: string;
+    name?: string;
+    expose: true;
+};
+export declare class RpcPublicError extends Error {
+    readonly expose = true;
+    constructor(message: string, name?: string);
+}
+export declare function isExposedRpcError(error: unknown): error is ExposedRpcError;
+export declare function serializeRpcError(error: unknown): RpcErrorInfo;
+export {};

package/dist/adapters/contracts/transport/rpc-error.js

@@ -0,0 +1,28 @@
+export const PUBLIC_RPC_ERROR_MESSAGE = 'An internal server error occurred';
+export class RpcPublicError extends Error {
+    expose = true;
+    constructor(message, name) {
+        super(message);
+        if (name) {
+            this.name = name;
+        }
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+export function isExposedRpcError(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'message' in error &&
+        typeof error.message === 'string' &&
+        'expose' in error &&
+        error.expose === true);
+}
+export function serializeRpcError(error) {
+    if (isExposedRpcError(error)) {
+        return {
+            message: error.message,
+            name: 'name' in error && typeof error.name === 'string' ? error.name : undefined,
+        };
+    }
+    return { message: PUBLIC_RPC_ERROR_MESSAGE };
+}

package/dist/runtime/server/system/processors/onRpc.processor.js

@@ -124,10 +124,21 @@ let OnRpcProcessor = class OnRpcProcessor {
                 });
                 throw error;
             }
-            if (hasNoDeclaredParams) {
-                return handler();
+            try {
+                if (hasNoDeclaredParams) {
+                    return await handler();
+                }
+                return await handler(player, ...validatedArgs);
+            }
+            catch (error) {
+                loggers.netEvent.error(`Handler error in RPC`, {
+                    event: metadata.eventName,
+                    handler: handlerName,
+                    playerId: player.clientID,
+                    accountId: player.accountID,
+                }, error);
+                throw error;
             }
-            return handler(player, ...validatedArgs);
         });
         loggers.netEvent.debug(`Registered RPC: ${metadata.eventName} -> ${handlerName}`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-core/framework",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "Secure, event-driven TypeScript Framework & Runtime engine for CitizenFX (Cfx).",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",